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Chapter  1 


Introduction 


A  few  years  ago,  my  computer  was  a  small  home  computer.  When  I  became 
interested  in  the  IBM  PC,  I  had  to  learn  a  lot  of  new  things.  I  learned  about  MS- 
DOS  and  became  familiar  with  8088  assembly  language.  I  soon  reached  a  point 
where  I  started  developing  commercial  PC  programs  in  partnership  with  my  friend 
Axel  Sellemerten.  All  of  this  happened  some  time  ago,  but  I  still  clearly 
remember  sitting  at  my  desk,  looking  through  dozens  of  PC  books  and  technical 
manuals,  trying  to  find  a  critical  piece  of  information. 

These  books  and  manuals  were  expensive  and  hard  to  find.  Besides,  none  of  them 
covered  all  aspects  of  the  PC.  Some  books  tell  you  about  PC  hardware  qt  the 
BIOS  QT  DOS.  I  could  never  find  a  book  that  dealt  with  the  PC  as  a  total  system. 
No  single  book  was  able  to  provide  me  with  a  complete  system  overview. 

This  book  is  the  result  of  my  experience  with  all  of  these  references.  The  three 
main  areas  of  the  PC  (hardware,  the  BIOS  and  DOS)  are  combined  in  this  book 
from  a  software  developer’s  point  of  view.  This  book  was  written  to  serve  as  an 
instruction  book  as  well  as  a  reference  manual.  It  is  not,  and  was  never  intended  to 
be,  a  book  for  the  beginner.  The  book  assumes  that  you’re  familiar  with  MS-DOS 
and  are  able  to  program  in  one  of  the  four  most  popular  PC  programming 
languages  (machine  language,  BASIC,  Pascal  or  C). 

Organization 

The  book  is  divided  into  five  parts.  Part  1  (Chapters  1-5)  gives  an  introduction  to 
the  PC’s  internal  components.  Part  2  (Chapter  6)  describes  the  Disk  Operating 
System  (DOS)  and  Part  3  (Chapter  7)  describes  the  Basic  Input  Output  System 
(BIOS).  PC  hardware  that  is  not  part  of  the  central  processor  is  discussed  in  Part  4 
(Chapters  8-18).  Part  5  (Chapter  19)  describes  the  interaction  between  these 
components  and  the  keyboard.  The  book  concludes  with  a  large  reference  section 
(Appendices)  containing  all  functions  of  DOS  and  the  BIOS,  among  other  things. 

To  understand  the  content  of  this  book,  you  must  first  know  something  about  the 
different  number  systems  used  in  computers.  Readers  unfamiliar  with  the  binary 
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and  hexadecimal  number  systems  should  read  Appendix  G  (Introduction  to  Number 
Systems)  before  continuing. 

Chapters  2  through  5  contain  descriptions  of  PC  microprocessors  and  interrupts.  If 
you’re  an  experienced  assembly  language  programmer  you  can  skip  these  chapters, 
but  you  may  learn  something  new  by  reading  them  anyway. 

BASIC,  Pascal  and  C  programmers  should  read  Chapters  2  and  3  and  should  work 
through  the  subsections  in  Chapter  4  devoted  to  your  preferred  language.  Chapter  5 
is  devoted  exclusively  to  assembly  language  programming  and  may  be  skipped. 
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The  PC's  Brain 


While  working  with  the  PC,  many  users  have  wondered  about  its  ability  to  solve 
complex  problems.  Users  often  attribute  these  abilities  to  the  software  or  operating 
system.  The  fact  is,  hardware  is  as  important  as  the  software. 

Microprocessor 

The  microprocessor  is  the  brain  of  the  PC.  It  understands  a  limited  number  of 
machine  language  instructions  and  processes  or  executes  programs  in  this  machine 
language.  These  instructions  are  very  simple  and  can’t  be  compared  to  commands 
in  high  level  languages  such  as  BASIC,  Pascal  or  C.  Commands  in  these 
languages  must  be  translated  into  a  large  number  of  machine  language  instructions 
that  the  PC’s  microprocessor  can  then  execute.  For  example,  displaying  text  with 
the  BASIC  PRINT  statement  requires  the  equivalent  of  several  hundred  machine 
language  instructions. 

Machine  language  instructions  differ  for  each  microprocessor  used  in  different 
computers.  When  you  hear  someone  talk  about  Z-80,  6502  or  8088  machine 
language,  these  terms  refer  to  the  microprocessor  being  programmed. 

Intel’s  80xx  series 

The  PC  has  its  own  family  of  microprocessor  chips,  all  designed  by  the  Intel 
Corporation.  The  figure  on  the  next  page  describes  the  Intel  80xx  family  tree. 
Your  PC  may  contain  an  8086,  an  8088  (used  in  the  PC/XT),  an  80186,  an  80286 
(used  in  the  AT)  or  even  an  80386  microprocessor.  The  first  generation  of  this 
group  (the  8086)  was  developed  in  1978.  The  successors  of  the  8086  were  different 
from  the  original  chip.  The  8088  is  actually  a  step  backward  since  it  has  the  same 
internal  structure  and  instructions  of  the  8086,  but  is  slower  than  the  8086.  The 
reason  is  that  the  8086  transfers  16  bits  (2  bytes)  between  memory  and  the 
microprocessor  at  one  time.  The  8088  is  slower  since  it  transfers  only  8  bits  (1 
byte)  at  one  time. 
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Multiprocessing 

The  three  other  microprocessors  of  this  family  are  improved  versions  of  the  8086, 
The  80186  offers  auxiliary  functions.  The  80286  has  additional  registers  and 
extended  addressing  capabilities.  The  80286’s  biggest  advantages  over  its 
predecessors  are  its  multiprocessing  and  virtual  memory  capabilities. 
Multiprocessing  allows  several  programs  to  execute  at  the  same  time,  such  as 
compiling  a  program  while  using  a  word  processor.  This  capability,  which  is 
based  on  the  fast  switching  between  the  individual  programs,  can  also  be 
implemented  through  software  (e.g.,  Microsoft  Windows®),  but  working  directly 
through  the  processor  is  more  efficient. 

Virtual  memory 

Virtual  memory  means  that  a  program  appears  to  use  much  more  memory  than  is 
available  in  the  computer’s  RAM.  Portions  of  the  programs  or  data  which  don’t  fit 
into  memory  are  temporarily  stored  on  the  mass  storage  device  (floppy  or  hard 
disk).  The  computer  loads  these  sections  into  RAM  as  needed.  The  CPU  and  the 
operating  system  share  the  task  of  virtual  memory  management.  Earlier  versions 
of  MS-DOS  don’t  support  the  multiprocessing  or  virtual  memory  capabilities  of 
the  80286,  so  most  AT  computers  aren’t  working  to  their  full  potential. 


Year 


The  Intel  80xx  processor  family 
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The  80386  represents  current  state  of  the  art  technology.  It  has  a  more  extensive 
instruction  set  than  the  80286,  and  offers  additional  memory  protection  features. 

These  processors  are  all  upwardly  compatible  with  software.  This  means  that 
machine  language  programs  developed  for  the  8086  can  be  executed  on  the  other 
processors  of  this  series.  On  the  other  hand,  a  program  written  for  the  80386  may 
not  run  correctly  on  the  80286  or  the  8088,  b^ause  instructions  available  on  the 
80386  may  not  be  available  in  the  earlier  processors. 

Throughout  this  book  the  PC  processor  is  designated  as  the  8088,  even  though 
your  PC  may  use  a  different  processor. 
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2.1  8088  Registers 


Registers  are  memory  locations  within  the  processor  itself,  instead  of  in  RAM. 
These  registers  can  be  accessed  much  faster  than  RAM.  In  addition,  registers  are 
specialized  memory  locations.  The  CPU  performs  arithmetic  and  logical  operations 
using  its  registers. 


Common  Registers 

ACX)UMULATOR 
BASE 
COUNT 
DATA 

DESTINATION  INDEX 

SOURCE  INDEX 
STACK  POINTER 
BASER  POINTER 


1  5  87  0 


AX 
Vh~1~  AL 


BX 


BH  1  BU 


..CX... 

CH  1  CL 


DX 

DH  1  DU 


Dl 


SI 


SP 


BP 


Segment  Registers 

DS 

DATA  SEGMENT 

ES 

EXTRA  SEGMENT 

CS 

CODE  SEGMENT 

SS 

STACK  SEGMENT 

Program  Counter 

INSTRUCTION 

IP 

POINTER 

Flag  Register 
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8088  registers 

All  registers  are  16  bits  (2  bytes)  in  size.  If  all  16  bits  of  a  register  contain  a  1, 
this  is  the  largest  number  that  can  be  represented  within  16  bits.  This  number  is 
the  decimal  number  65535.  Therefore,  a  register  can  contain  any  value  from  0  to 
65535. 

Register  groupings 

As  shown  in  the  above  figure,  registers  are  divided  into  four  groups:  common 
registers,  segment  registers,  the  program  counter  and  the  flag  register.  The  different 
register  assignments  are  designed  to  duplicate  the  way  in  which  a  program 
processes  data — which  is  the  basic  task  of  a  microprocessor. 

The  disk  operating  system  and  the  routines  stored  in  ROM  use  the  common 
registers  a  great  deal,  especially  the  AX,  BX,  CX  and  DX  registers.  The  contents 
of  these  registers  tell  DOS  what  tasks  it  should  perform  and  which  data  to  use  for 
execution. 
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These  registers  are  affected  mainly  by  mathematical  (addition,  subtraction,  etc.)  and 
input/output  instructions.  They  are  assigned  a  special  position  within  the  registers 
of  the  8088  because  they  can  be  separated  into  two  8-bit  (1-byte)  registers.  Each 
common  register  may  be  thought  to  consist  of  three  registers:  a  single  16-bit 
register,  or  two  smaller  8-bit  registers. 


bit  15  bit  8  bit  7 


bit  0 


bit  15 


bit  0 


AX  register 

The  registers  have  designators  of  H  (high)  and  L  (low).  Thus  the  16-bit  AX 
register  may  be  divided  into  an  8-bit  AH  and  an  8-bit  AL  register.  The  H  and  the  L 
register  designators  occur  in  such  a  way  that  the  L  register  contains  the  lower  8 
bits  (bit  0  through  7)  of  the  X  register,  and  the  H  register  the  higher  8  bits  (bits  8 
through  15)  of  the  X  register.  The  AH  register  consists  of  bits  8-15  and  the  AL 
register  of  bits  0-7  of  the  AX  register.  However,  the  three  registers  cannot  be 
considered  independent  of  each  other.  For  example,  if  bit  3  of  the  AH  register  is 
changed,  then  the  value  of  bit  11  of  the  AX  register  also  changes  automatically. 
The  values  change  in  both  the  AH  and  the  AX  registers.  The  value  of  the  AL 
register  remains  constant  since  it  is  made  of  bits  0-7  of  the  AX  register  (bit  1 1  of 
the  AX  register  does  not  belong  to  it).  This  connection  between  the  AX,  the  AH 
and  the  AL  register  is  also  valid  for  all  other  common  registers  and  can  be 
expressed  mathematically. 

You  can  determine  the  value  of  the  X  register  from  the  values  of  the  H  and  the  L 
registers,  and  vice  versa.  To  calculate  the  value  of  the  X  register,  multiply  the 
value  of  the  H  register  by  256  and  add  the  value  of  the  L  register. 

Example:  The  value  of  the  CH  register  is  10,  the  value  of  the  CL  register  is 
118.  The  value  of  the  CX  register  results  from  CH*256+CL,  which 
is  10*256+118  =  2678. 

Specifying  register  CH  or  CL,  you  can  read  or  write  an  8-bit  data  item  from  or  to 
any  memory  location.  Specifying  register  CX,  you  can  read  or  write  a  16-bit  data 
item  from  or  to  a  mernwy  location. 
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2.2  Segment  and  Offset  Addressing 

One  of  the  design  goals  of  the  8088  was  to  provide  an  instruction  set  that  was 
superior  to  the  earlier  8-bit  microprocessors  (6502,  Z80,  etc.).  A  second  goal  was 
to  provide  easy  access  to  more  than  64  kilobytes  of  memory.  This  god  was  of 
special  importance  since  increasing  processor  capabilities  allow  programmers  to 
write  more  complex  applications,  which  in  turn  require  more  memory.  The 
designers  of  the  8088  increased  the  memory  capacity  or  address  space  of  the 
microprocessor  by  more  than  16  times  to  one  megabyte. 

Address  register 

The  number  of  memory  locations  which  a  processor  can  access  depends  on  the 
width  of  the  address  register.  Since  every  memory  location  is  accessed  by 
specifying  a  unique  number  or  address,  the  maximum  value  contained  in  the 
address  register  determines  the  address  space.  Earlier  microprocessors  used  a  16-bit 
address  register  enabling  access  to  addresses  from  0  to  65535.  This  corresponds  to 
the  64K  memory  capacity  of  these  processors. 

To  address  one  megabyte  of  memory  the  address  register  must  be  at  least  20  bits 
wide.  At  the  time  the  8088  was  developed,  it  was  impossible  to  use  a  20-bit 
address  register,  so  the  designers  used  an  ^temate  way  to  achieve  the  20-bit  width: 
the  contents  of  two  different  16-bit  numbers  are  used  to  form  the  20-bit  address. 

Segment  register 

One  of  the  numbers  is  contained  in  a  segment  register.  The  8088  has  four  segment 
registers.  The  second  number  is  contained  in  another  register  or  in  a  memory 
location.  To  form  a  20-bit  number,  the  contents  of  the  segment  register  are  shifted 
left  by  4  bits  (thereby  multiplying  the  value  by  16)  and  the  second  number  is  added 
to  the  first 

Segment  and  offset  addresses 

These  addresses  are  the  segment  address  and  the  offset  address.  The  segment  address 
is  formed  by  a  segment  register  and  indicates  the  start  of  a  segment  of  memory. 
During  the  address  formulation,  the  offset  address  is  added  to  the  segment  address. 
The  offset  address  indicates  the  number  of  the  memory  location  within  the  segment 
whose  beginning  was  defined  by  the  segment  register.  Since  the  offset  address  can 
never  be  larger  than  16  bits,  a  segment  can  be  no  larger  than  65,535  bytes  (64K). 

Segmented  address 

The  segmented  address  results  from  the  combined  segment  and  offset  addresses. 
This  segmented  address  specifies  the  exact  number  of  the  memory  location  which 
should  be  accessed.  Unlike  the  segmented  address,  the  segment  and  the  offset 
addresses  are  relative  addresses  or  relative  offsets. 
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Memory  structure  using  segment  and  offset  addresses 

A  segment  cannot  start  at  every  one  of  the  million  or  so  memory  locations. 
Multiplying  the  segment  register  by  16  always  produces  a  segment  address  that  is 
divisible  by  16.  For  example,  it’s  not  possible  for  a  segment  to  begin  at  memory 
location  22. 


Combining  the  segment  and  offset  addresses  requires  special  notation  to  indicate  a 
memory  location’s  address.  This  notation  consists  of  the  segment  address  in  four¬ 
digit  hexadecimal  format,  followed  by  a  colon,  and  the  offset  address  in  four-digit 
hexadecimal  format.  For  example,  a  memory  location  with  a  segment  address  of 
2(XX)H  and  an  offset  address  of  AF3H  would  appear  in  this  notation  as  2(XX):0AF3. 
Because  of  this  notation,  you  can  omit  the  H  suffix  from  hexadecimal  numbers. 
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Segment  and  offset  address 

The  8088  has  four  segment  registers,  which  have  special  roles  in  the  execution  of 
an  assembly  language  program.  There  are  four  registers  to  accommodate  the  basic 
structure  of  any  program.  A  program  consists  of  a  set  of  instructions  (code).  There 
are  also  variables  and  data  items  that  are  processed  by  the  program.  A  structured 
program  keeps  the  code  and  data  separate  from  each  other  while  they  reside  in 
memory.  Assigning  code  and  data  their  own  segments  conveniently  separates 
them. 

Each  needs  a  segment  address  and  a  segment  register.  The  CS  (Code  Segment) 
register  uses  the  IP  (Instruction  Pointer)  register  as  the  offset  address.  The  CS  then 
determines  the  address  at  which  the  next  assembly  language  instruction  is  located. 
The  IP  is  also  called  the  Program  Counter.  When  the  processor  executes  the 
current  instruction,  the  IP  register  is  automatically  incremented  to  point  to  the 
next  assembly  language  instruction.  This  ensures  the  execution  of  instructions  in 
the  correct  order. 
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of  the  data  which  the  program  accesses  (writing  or  reading  data  to  or  from 
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memory).  The  offset  address  is  added  to  the  content  of  the  DS  register  and  may  be 
contained  in  another  register  or  may  be  contained  as  part  of  the  current  instruction. 

The  SS  (Stack  Segment)  register  specifies  the  starting  address  of  the  stack.  The 
stack  acts  as  temporary  storage  space  by  some  assembly  language  programs.  It 
allows  fast  storage  and  retrieval  of  data  for  various  instructions.  For  example, 
when  the  CALL  instruction  is  executed,  the  processor  places  the  return  address  on 
the  stack.  The  SS  register  and  either  the  SP  or  BP  registers  form  the  address  that  is 
pushed  onto  the  stack. 

The  last  segment  register  is  the  ES  (Extra  Segment)  register.  It  is  used  by  some 
assembly  language  instructions  to  address  more  than  64K  of  data  or  to  transfer  data 
between  two  different  segments  of  memory. 


ESiFFFF 


ES:0000 

CS:FFFF 


CSiOOOO 

SS:FFFF 


SS:0000 

DSiFFFF 


DS; 0000 


Overlapping  and  non-overlapping  segments 

As  the  figure  above  shows,  two  segment  registers  can  specify  areas  of  memory 
which  overlap,  or  are  completely  different  from  one  another.  In  many  cases,  a 
program  doesn’t  require  a  full  segment  for  storing  code  or  data.  You  can 
conserve  memory  by  overlapping  the  segments.  For  example,  you  can  store  data 
immediately  following  the  program  code  by  setting  the  DS  and  CS  registers 
accordingly. 


segments 


Overlapping 
segments 
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The  flag  register  is  of  special  importance.  Various  bits  in  this  register  indicate  or 
signal  the  special  conditions  which  may  occur  during  execution  of  an  assembly 
language  instruction.  For  example,  if  an  arithmetic  operation  results  in  a  negative 
number,  the  processor  sets  the  S  (sign)  flag  to  1  to  indicate  this  change. 

The  C  (carry)  flag  is  set  to  1  if  the  sum  of  two  8-bit  numbers  cannot  be 
represented  as  an  8-bit  number. 

As  the  figure  above  shows,  the  processor  doesn’t  use  all  16  bits  of  this  register. 
The  unused  bits  normally  contain  the  value  0. 

This  ends  our  short  trip  into  the  PC’s  brain.  If  you  didn’t  quite  follow  some  of 
these  concepts,  the  sample  application  programs  in  the  sections  on  the  BIOS  and 
DOS  functions  should  help  you  understand. 
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2.3  The  CPU  Support  Chips 

The  microprocessor  is  the  computer’s  brain,  and  is  probably  the  most  intelligent 
component  in  a  computer  system.  However,  it  cannot  supervise  all  the  computer’s 
functions  on  its  own.  For  this  reason,  other  components  called  support  chips 
perform  many  other  tasks,  leaving  the  processor  to  concentrate  on  its  primary  task 
of  executing  assembly  language  programs. 

These  support  chips  communicate  with  and  control  external  peripherals  such  as  a 
disk  drive  or  the  screen  display. 

Some  of  these  support  chips  can  be  programmed  using  the  assembly  language 
instructions  IN  and  OUT.  Since  the  programming  of  most  support  chips  is  very 
complex,  we  recommend  that  you  leave  this  up  to  DOS,  unless  you  have  a 
complete  understanding  of  the  structure  and  operation  of  these  chips. 

The  following  sections  define  the  most  important  support  chips  in  the  PC. 

2.3.1  The  DMA  Controller 

This  chip  gets  its  name  from  the  acronym  DMA  which  stands  for  Direct  Memory 
Access.  This  chip  can  directly  write  data  to  or  read  data  from  RAM.  The  DMA 
controller  performs  disk  input/output  operations,  moving  data  from  RAM  to  disk 
or  from  disk  to  RAM.  This  relieves  the  processor  of  this  task  and  accelerates 
program  execution. 

2.3.2  The  Interrupt  Controller 

Interrupts  are  signals  from  individual  components  of  the  system  to  get  the  CPU’s 
attention  and  to  initiate  certain  tasks.  Several  interrupts  or  requests  for  services 
from  different  system  components  can  be  outstanding  at  one  time.  These  requests 
are  initially  handled  by  the  interrupt  controller,  which  passes  them  on  to  the  CPU. 
It  assigns  priority  to  every  interrupt  request  according  to  its  source  and  passes  the 
request  with  the  highest  priority  to  the  CPU.  The  interrupt  controller  in  the 
PC/XT  can  process  up  to  8  interrupt  requests  at  the  same  time.  ATs  require  more 
power,  so  they  use  two  interconnected  interrupt  controllers  which  can  process  up 
to  15  interrupt  requests  simultaneously. 

2.3.3  The  Programmable  Peripheral  Interface 

This  chip  provides  a  link  between  the  CPU  and  the  peripherals  such  as  the 
keyboard  or  an  audio  speaker.  However,  it  only  operates  as  a  mediator,  addressed  by 
the  CPU  for  unit  access  and  transmission  of  certain  signals.  You  cannot  bypass 
the  PPI  for  direct  communication  between  the  CPU  and  peripherals. 
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2.3.4  The  Clock 

If  the  microprocessor  is  the  brain  of  the  computer,  then  the  clock  could  be 
considered  the  heart  of  the  computer.  This  heart  beats  several  million  times  a 
second  (about  14.3  megaHertz)  and  paces  the  microprocessor  and  the  other  chips  in 
the  system.  Since  almost  none  of  the  chips  operate  at  such  high  frequencies,  each 
support  chip  modiHes  the  clock  frequency  to  its  own  requirements. 

2.3.5  The  Timer 

The  timer  chip  can  be  used  as  a  counter  and  timekeeper.  This  chip  transmits 
constant  electrical  pulses  from  one  of  its  output  pins.  The  frequency  of  these 
pulses  can  be  programmed  as  needed,  and  each  output  pin  can  have  its  own 
frequency.  Each  output  pin  leads  to  another  component.  One  line  goes  to  the  audio 
speaker  and  another  to  the  interrupt  controller.  The  line  to  the  interrupt  controller 
triggers  interrupt  8  at  every  pulse,  which  advances  the  timer  count. 

2.3.6  The  Screen  Controller 

Unlike  the  chips  discussed  up  until  now,  the  CRT  (Cathode  Ray  Tube)  controller 
is  separate  from  the  main  circuit  board  of  the  PC.  You’ll  find  this  chip  on  the 
video  board  which  is  mounted  in  one  of  the  computer’s  expansion  slots.  Even 
though  there  are  many  boards  that  differ  widely  in  their  capabilities  (monochrome 
display,  color  display,  etc.),  all  video  boards  are  based  on  the  6845  CRT  controller. 
It  produces  a  display  on  the  monitor  connected  to  the  computer.  The  controller  has 
several  internal  registers  which  control  the  output  of  the  display. 

2.3.7  The  Disk  Controller 

This  chip  is  also  usually  located  on  an  expansion  board.  It  is  addressed  by  the 
operating  system  and  controls  the  functions  of  the  disk  drive.  It  moves  the 
read/wrile  head  of  the  disk  drive  over  the  disk,  reads  data  from  the  disk  and  writes 
data  to  the  disk. 

2.3.8  The  Math  Coprocessors  (8087/80287/80387) 

The  8088,  80286  and  the  80386  are  not  capable  of  performing  floating  point 
arithmetic  operations  directly.  There  is  a  socket  on  the  main  circuit  board  of  the 
PC  for  adding  a  special  math  coprocessor.  The  PC/XT  uses  the  8087,  the  AT  the 
80287  and  the  new  80386  uses  the  80387  cop’ocessOT. 

While  floating  point  arithmetic  can  be  performed  using  software  routines,  a  math 
coprocessor  is  up  to  1(X)  times  faster.  The  8087  and  the  80287  can  perform  basic 
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math  functions  such  as  addition,  subtraction,  multiplication  and  division,  as  well 
as  the  trigonometric  functions  sine,  cosine,  etc.  lihey  can  also  compute  square 
roots  of  numbers. 

In  general,  only  a  few  application  software  packages  support  the  math 
coprocessors. 
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2.4  The  CPU  and  Memory 

While  the  chips  described  up  until  now  are  intelligent  system  components, 
memory  is  a  passive  element.  Data  can  be  stwed  and  later  retrieved  from  memory. 
Each  memory  location  is  used  to  store  one  byte  (8  bits)  of  data.  Memory  locations 
are  identified  by  a  unique  address,  starting  from  zero. 

The  support  chips  communicate  with  memory  using  a  bus  or  path  over  which  the 
electronic  signals  travel. 

Address  bus 

The  address  bus  carries  the  number  of  the  memory  location  to  be  accessed.  The 
signals  on  the  bus  represent  a  binary  number  whose  value  indicates  the  memory 
location  for  access.  Since  only  those  memory  locations  represented  on  the  address 
bus  can  be  accessed,  the  number  which  make  up  the  bus  lines  determine  the 
number  of  addressable  memory  locations. 

,  The  PC/XT  has  a  20-bit  address  bus  and  can  address  a  maximum  of  2^  (about  1 
million)  different  memory  locations.  The  AT  has  a  24-bit  address  bus  and  can 
address  more  than  16  million  memcMy  locations. 

Data  bus 

Once  the  bus  knows  the  address  of  the  memory  location  to  be  accessed,  data  can  be 
transferred  between  the  individual  chips  and  the  memory  location  over  the  data  bus. 
The  number  of  lines  in  this  circuit  determine  how  many  bits  are  transferred  to  or 
from  memory  simultaneously. 

The  PC/XT  has  8  lines  so  it  can  transfer  one  byte  at  a  time.  However,  since  the 
8088  is  a  16-bit  processor,  16-bit  data  must  often  be  transferred.  There  aren’t 
enough  lines  to  transfer  16-bit  data,  so  the  system  divides  a  16-bit  data  item  into 
two  8-bit  numbers.  These  two  8-bit  data  bytes  are  transferred  one  after  the  other 
along  the  bus. 

The  8086  and  80286  processors  can  transfer  16  bits  simultaneously  over  their  16- 
bit- wide  data  buses.  This  is  one  reason  why  the  AT  executes  programs  faster  than 
the  8088  processor.  The  80386  processor  can  transfer  32  bits  at  a  time. 

Word  storage 

All  members  of  the  Intel  80xx  processor  family  share  the  same  method  of  storing 
words  (16-bit  data)  in  memory.  The  lower  numbered  memory  location  contains 
bits  0-7  (the  low  byte)  and  the  higher  numbered  memory  location  contains  bits  8- 
15  (the  high  byte).  For  example,  if  you  store  the  word  3F87H  starting  at  address 
0000:0400,  memory  location  0000:0400  accepts  the  low  byte  87H  and  memory 
location  0000:0401  accepts  the  high  byte  3FH. 
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Two  details  were  left  out  of  the  discussion  of  memory  so  far: 

1 . )  The  processor  doesn’t  care  if  a  memory  address  is  located  in  a  RAM  chip 

or  a  ROM  chip.  The  main  difference  between  RAM  and  ROM  lies  in  the 
fact  that  you  can’t  write  or  store  new  data  into  ROM  (hence  its  name: 
Read  Only  Memory). 

2. )  The  addressable  space  of  the  microprocessor  (1  megabyte)  is  allocated  into 

16  storage  segments  of  64K  each.  This  is  an  almost  universal  division 
used  on  IBM  PC/XTs  and  most  compatible  machines. 


Block  I Addresses 
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Memory  allocation 

The  first  10  memory  segments  are  reserved  for  the  main  RAM  memory,  limiting 
maximum  RAM  to  640K.  A  computer’s  memory  size  may  differ  from  one  PC 
manufacturer  to  another  but  has  at  least  64K  installed  in  segment  0.  If  you  install 
additional  RAM,  its  first  memory  address  must  immediately  follow  the  last 
existing  memory  address,  since  no  gaps  may  exist  between  individual  RAM 
memory  segments.  Memory  segment  0  has  a  special  role  since  it  contains 
important  data  and  operating  system  routines. 

Memory  segment  A  follows  the  RAM  memory.  In  this  case,  an  EGA  (Extended 
Graphics  Adapter)  is  installed.  This  board  uses  the  memory  for  the  screen  display 
in  different  graphic  modes. 

Memory  segment  B  is  resCTved  for  a  monochrome  or  color  graphics  board.  They 
share  the  segment  as  screen  memory.  The  monochrome  board  uses  the  lower  32K 
and  the  color  board  uses  the  upper  32K.  Each  board  uses  only  as  much  memory  as 
it  needs  for  the  screen  display.  The  monochrome  board  uses  4K;  the  color  board 
uses  16K  because  of  the  additional  color  capabilities. 
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The  next  memory  segment  contains  ROM  beginning  at  segment  C.  Some 
computers  store  the  BIOS  routines  which  aren’t  part  of  the  original  BIOS  kernel  at 
this  location.  For  example,  the  XT  uses  these  routines  for  hard  disk  support  Since 
this  area  isn’t  fully  utilized,  it  is  possible  that  BIOS  routines  supporting  future 
hardware  enhancements  will  also  be  placed  in  this  memory  range. 

ROM  cartridges 

Segments  D  and  E  are  reserved  for  ROM  cartridges.  These  cartridges  extend  the 
computer  with  certain  ROM  routines.  The  PC  has  rarely  used  them  and  the  area 
usually  remains  unused. 

Segment  F  contains  the  actual  BIOS  routines,  the  system  loader  and  the  ROM 
BASIC  available  on  many  computers. 
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Introduction  to  Interrupts 


This  chapter  presents  a  view  of  interrupts,  which  are  vitally  important  to  the 
operation  of  the  8088  processor.  An  interrupt  is  a  signal  from  a  peripheral  device 
or  a  request  from  a  program  to  perform  a  specific  service.  When  an  interrupt 
occurs,  the  currently  executing  program  is  temporarily  suspended  and  an  interrupt 
routine  begins  execution  to  handle  the  condition  that  caused  the  interrupt 


Program  Interrupt  routine 


Program  interrupt 

When  a  program  is  suspended,  the  processor  saves  the  contents  of  the  CS  and  IP 
registers  on  the  stack,  and  begins  the  interrupt  routine.  After  the  interrupt  routine 
has  completed  its  task,  it  issues  the  IRET  (Interrupt  RETum)  instruction  which 
restores  the  contents  of  the  CS  and  IP  registers  from  the  stack,  thus  resuming  the 
program. 

The  interrupt  routine  saves  and  restores  contents  of  the  other  registers  before 
returning  to  the  interrupted  program. 
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3.1  The  Structure  of  the  Interrupt  Vector  Table 

So  far  we’ve  talked  about  a  single  interrupt  and  a  single  interrupt  routine.  In  fact, 
the  8088  has  2S6  possible  interrupts  numbered  from  0  to  255,  not  just  one. 

Each  interrupt  has  an  associated  interrupt  routine  to  handle  the  particular  condition. 
To  organize  the  256  interrupts,  the  starting  address  of  the  corresponding  intarupt 
routines  are  arranged  in  the  interrupt  vector  table. 

When  an  interrupt  occurs,  the  processor  automatically  retrieves  the  starting  address 
of  the  interrupt  routine  from  the  interrupt  vector  table. 

The  starting  address  of  each  interrupt  routine  is  specified  in  the  table  in  terms  of 
the  offset  address  and  segment  address.  Both  addresses  are  16  bits  (2  bytes)  wide. 
Therefore  each  table  entry  occupies  4  bytes.  The  total  length  of  the  table  is  256*4 
or  1024  bytes  (IK). 
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Single-step 
Division  by  0 


Interrupt  vector  table 
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The  table  itself  is  located  in  memory  from  OH  to  3FFH.  Since  the  interrupt’s 
number  is  the  same  as  the  table  entry  for  the  corresponding  interrupt  routine,  the 
intenupt  routine  address  for  interrupt  0  is  the  zero  table  entry  in  locations  0H-3H. 
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Memory  locations  4H — 7H  contain  the  address  for  the  interrupt  routine  for 
interrupt  1,  etc.  The  last  interrupt,  interrupt  255,  occupies  the  end  of  the  table  at 
locations  3FCH — 3FFH. 

To  calculate  the  starting  address  of  an  interrupt,  simply  multiply  the  interrupt 
number  by  four. 

Advantages 

An  advantage  of  using  the  interrupt  vector  table  is  that  it*s  easy  to  change  an  entry 
in  the  table  to  the  starting  address  of  a  user- written  interrupt  routine.  This  makes  a 
new  interrupt  routine  available  to  any  program  which  can  invoke  the  routine 
simply  by  executing  the  corresponding  interrupt  instruction. 

The  next  section  explains  the  different  types  of  interrupts  and  how  they  are  used  in 
the  system. 


21 


3.  Introduction  to  Interrupts 


PC  System  Programming 


3.2  Interrupt  Types 


Until  now,  we  haven’t  talked  about  different  types  of  interrupts.  There  are  two 
major  types  of  interrupts — ^hardware  intmupts  and  software  interrupts. 

The  figure  below  shows  the  different  interrupt  types. 


Interrupt  types 


3.2.1  Software  Interrupts 

A  software  interrupt  is  an  interrupt  called  by  the  INT  instruction  in  a  machine 
language  program.  The  INT  instruction  includes  the  number  of  the  interrupt  to  be 
signalled.  For  example,  the  instruction  to  call  intmiipt  5,  which  sends  a  hardcopy 
of  the  current  screen  to  the  printer,  appears  as  INT  5.  The  INT  instruction  allows 
you  to  call  any  one  of  the  256  interrupts. 

Software  interrupts  make  it  possible  to  use  many  of  the  basic  operating  system 
services  from  either  the  assemblo-  (or  machine  language)  level  or  from  many  of  the 
higher  level  languages  which  support  interrupt  processing. 

3.2.2  Hardware  Interrupts 

A  hardware  device  such  as  a  disk  drive  or  keyboard  can  trigger  a  hardware  interrupt. 
This  is  a  simple  and  efficient  mechanism  for  handling  events  which  require 
attention. 

One  example  is  the  keyboard.  When  you  press  or  release  a  key,  interrupt  9  (the 
keyboard  interrupt)  is  signalled.  The  standi  DOS  interrupt  routine  responds  by 
placing  the  character  value  corresponding  to  the  key  that  was  pressed  into  the 
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keyboard  buffer  following  any  value  which  may  have  been  previously  there.  If  the 
keyboard  buffer  is  full,  the  routine  generates  a  short  beep.  As  in  any  other 
interrupt,  the  original  program  continues  after  the  completion  of  the  interrupt 
routine. 

Maskable  interrupts 

This  interrupt  is  designated  as  an  external  hardware  interrupt,  because  it  was 
triggered  by  an  external  device.  For  these  interrupts,  a  distinction  is  also  made 
between  maskable  and  non-maskable  interrupts.  The  keyboard  interrupt  just 
described  belongs  in  the  maskable  interrupt  category.  You  can  mask  (disable)  this 
interrupt  by  using  the  assembler  instruction  STI  (SeT  Interrupt  flag).  If  you  mask 
interrupt  9H,  the  keyboard  ignores  any  characters  you  type.  To  reverse  this 
condition,  use  the  CLI  instruction  (CLear  Interrupt  flag)  to  re-enable  the  interrupt. 

Non-maskable  interrupts 

In  contrast,  a  non-maskable  interrupt  cannot  be  disabled  by  the  STI  instruction. 
One  example  is  interrupt  2.  This  interrupt  indicates  an  error  in  the  PC’s  memory. 
It  displays  a  message  on  the  screen  that  one  or  more  of  the  RAM  chips  is  defective 
and  should  be  replaced. 

The  last  interrupt  type  to  be  described  is  the  internal  hardware  interrupt.  The 
processors  on  the  main  circuit  board  of  the  PC  trigger  this  interrupt.  One  example 
is  interrupt  8  which  is  designated  as  a  timer  interrupt.  The  timer  triggers  this 
interrupt  at  a  rate  of  12.8  times  per  second.  It  also  disables  the  disk  drive  motor  if 
no  disk  access  is  in  progress. 
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3.3  Interrupts  at  a  Glance 

The  tables  hoe  show  the  significance  which  these  interrupts  occupy  in  the  control 
and  use  of  the  PC.  The  next  few  ch^ters  explain  these  interrupts  in  more  detail. 


'  Nr. 

Vector 

Purpose 

00 

000  -  003 

CPU:  Division  by  zero 

01 

004  -  007 

CPU:  Single  step 

02 

008  -  OOB 

CPU:  NMI  (Error  in  RAM  chip) 

03 

OOC  -  OOF 

CPU:  Breakpoint 

04 

010  -  013 

CPU:  Numeric  overflow 

05 

014  -  017 

Hardcopy 

06 

018  -  OIB 

Unknown  instruction  (80286  only) 

07 

OID  -  OIF 

reserved 

08 

020  -  023 

IRQO:  Timer  (Call  18. 2  per/ sec. ) 

09 

024  -  027 

IRQl :  Keyboard 

OA 

028  -  02B 

IRQ2:  Second  8259  (AT  only) 

OB 

02C  -  02F 

IRQ3:  Serial  interface  2 

OC 

030  -  033 

IRQ4:  Serial  interface  1 

OD 

034  -  037 

IRQ5:  Hard  disk 

OE 

038  -  03B 

IRQ6:  Diskette 

OF 

03C  -  03F 

IRQ7:  Printer 

10 

040  -  043 

BIOS:  Video  functions 

11 

044  -  047 

BIOS:  Determine  configuration 

12 

048  -  04B 

BIOS:  Determine  RAM  storage  size 

13 

04C  -  04F 

BIOS:  Diskette/hard  disk  functions 

14 

050  -  053 

BIOS:  Access  to  serial  interface 

15 

054  -  057 

BIOS:  Cassette/enhanced  functions 

16 

058  -  05B 

BIOS:  Keyboard  sensing 

17 

05C  -  05F 

BIOS:  Access  to  parallel  printer 

18 

060  -  063 

Call  of  ROM-BASIC 

19 

064  -  067 

BIOS:  System  boot  (ALT+CTRL+DEL) 

lA 

068  -  06B 

BIOS:  Read  time/date 

IB 

06C  -  06F 

Break  key  not  activated  (not  CTRL-C) 

1C 

070  -  073 

called  after  every  INT  08 

ID 

074  -  077 

Address  of  the  video  parameter  table 

IE 

078  -  07B 

Address  of  the  disk  parameter  table 

IF 

07C  -  07F 

Address  of  the  character  bit  pattern 

20 

080  -  083 

DOS:  Terminate  program 

21 

084  -  087 

DOS:  Call  DOS  function 

22 

088  -  08B 

Address  of  DOS  end  of  program  routine 

23 

08C  -  08F 

Address  of  DOS  CTRL-BREAK  routine 

24 

090  -  093 

Address  of  DOS  error  routine 

25 

094  -  097 

DOS:  Read  diskette/hard  disk 

26 

098  -  09B 

DOS:  Write  diskette/hard  disk 

27 

09C  -  09F 

DOS:  End  Prg.,  remain  resident 

28- 

OAO  - 

Reserved  for  various,  non- 

3F 

-  OFF 

documented  DOS  functions 

40 

100  -  103 

BIOS:  diskette  functions 

41 

104  -  107 

Address  of  hard  disk  table  1 

42- 

108  - 

Reserved 

45 

-  117 

46 

118  -  IIB 

Address  of  hard  disk  table  2 

47- 

lie  - 

can  be  used  by  application  programs 

49 

-  127 

for  any  purpose 
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Vector 

4A 

128  -  12B 

Alarm  time  reached  (AT  only) 

4B- 

12C  - 

Can  be  used  by  application  programs 

67 

-  19F 

for  any  purpose 

68- 

lAO  - 

Unused 

6F 

-  IBF 

70 

ICO  -  1C3 

IRQ08:  Realtime  clock  (AT  only) 

71 

1C4  -  1C7 

IRQ09:  (AT  only) 

72 

1C 8  -  ICB 

IRQlO:  (AT  only) 

73 

ICC  -  ICF 

IRQll:  (AT  only) 

74 

IDO  -  1D3 

IRQ12:  (AT  only) 

75 

1D4  -  1D7 

IRQ13;  80287  NMI  (AT  only) 

76 

1D8  -  IDB 

IRQ14:  Hard  disk  (AT  only) 

77 

IDC  -  IDF 

IRQ15:  (AT  only) 

78- 

lEO  - 

Unused 

7F 

-  IFF 

80- 

200  - 

Used  by  the  BASIC 

FO 

-  3C3 

interpreter 

Fl- 

3C4  - 

Unused 

FF 

-  3CF 

General  overview — interrupts 


Chapter  4 


Using  Interrupts  from  High 
Level  Languages 


The  assembly  language  programmer  can  invoke  an  interrupt  by  loading  the 
parameters  required  by  the  interrupt  routine  into  designated  registers  and  executing 
the  INT  instruction.  Although  these  capabilities  aren’t  available  in  all  higher  level 
languages,  some  languages  such  as  Turbo  Pascal®,  Turbo  C®  and  Microsoft  C® 
have  built-in  functions,  procedures  or  subroutines  to  call  the  interrupt. 

A  BASIC  programmer  can  call  an  interrupt  using  a  short  assembly  language  pro¬ 
gram.  You’ll  find  an  example  of  this  in  Section  4.1. 

This  chapter  provides  information  on  calling  interrupts  from  Pascal,  BASIC  and 
C.  Each  describes  how  interrupts  can  be  called  in  the  particular  language  and  the 
rules  the  programmer  must  observe.  Each  section  concludes  with  a  short 
demonstration  program. 

Read  through  the  section  devoted  to  the  language  with  which  you  feel  most 
comfortable.  A  comparison  of  the  three  sample  programs  could  be  interesting  for 
those  of  you  who  wish  to  compare  the  similarities  and  differences  in  the  three 
languages. 

The  programs  are  only  examples.  Experiment  as  much  as  you  want-you  won’t 
damage  your  computer  if  you  change  them  a  little. 
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4.1  Interrupt  Calls  from  BASIC 

The  two  most  commonly  used  BASIC  interpreters  are  BASICA  (from  IBM)  and 
GW-BASIC  (from  Microsoft).  This  book  refers  to  GW-BASIC,  since  it  can  be 
used  on  IBM  PCs  as  well  as  any  compatible  PC.  The  command  sets  of  both  are 
nearly  identical. 

GW-BASIC  does  not  have  a  function  for  calling  interrupts.  However,  the  CAUL 
command  can  be  used  to  execute  a  machine  language  program.  You  can  also  use 
the  CALL  command  to  pass  certain  parameters  to  the  called  program.  The  called 
machine  language  program  must  be  located  in  the  64K  used  by  GW-BASIC  for 
program  statements  and  variable  storage.  Because  of  this,  the  interpreter  must  be 
told  to  reserve  part  of  program  memory  for  the  machine  language  routine. 
Otherwise  the  program  or  variables  may  overwrite  the  machine  language  routine, 
causing  a  system  crash.  You  can  reserve  memory  directly  when  you  call  BASIC 
from  the  operating  system.  Enter  the  name  GWBASIC  followed  by  the  /M: 
parameter.  After  the  colon,  enter  the  highest  memory  location  you  want  used  by 
BASIC.  For  example,  since  the  sample  program  starts  at  memory  location  60000, 
start  the  GW-BASIC  interpreter  as  follows: 

gwbasic  /rti;  60000 


This  reserves  the  required  memory  space.  Now  you  can  place  the  machine  language 
routine  into  memory  by  making  it  part  of  the  current  BASIC  program  and  loading 
it  into  memory  using  a  suitable  subroutine.  The  current  BASIC  program  must 
contain  the  following  commands: 


60000 

60010 

60020 

60030 

60040 

60050 

60060 

60070 

60080 

60090 

60100 

60110 

60120 

60130 

60140 

60150 

60160 

60170 

60180 

60190 

60200 

60210 

60220 

60230 


•  ****** ************************************************* ********  I 

'*  initialize  the  routine  for  the  interrupt  call  *' 

•  * - *  • 

' *  Input :  none  * ' 

'*  Output:  lA  is  the  Start  address  of  the  Interrupt  routine  *' 
****************************************************************1 


IA=60000!  'Start  address  of  the  routine  in  the  BASIC  segment 

DEF  SEG  'set  BASIC  segment 

RESTORE  60130 

FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'poke  Routine 
return  'back  to  caller 


DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 
DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 
DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 
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that  the  parameters  used  to  start  GW-BASIC  must  also  be  changed  so  that  the 
routine  cannot  be  overwritten  by  the  variables  of  the  program. 

To  use  the  machine  language  routine  to  call  an  interrupt,  this  subroutine  must  of 
course  be  called  first.  The  first  line  of  the  user  program  should  therefore  be: 

100  GOSUB  60000 

The  actual  program  which  calls  the  interrupt  function  during  its  execution  can  be 
stored  between  line  numbers  100  and  60000.  The  following  program  line 
demcmstrates  how  this  can  be  dcxie: 

200  CALL  IA(INTNR%,AH%,AL%,BH%,BL%,CH%,CL%,DH%,DL%,DI%,SI%,ES%,FLAGS%) 

The  variables  within  parentheses  are  the  variables  passed  to  the  assembly  language 
program.  All  variables  must  pass  true  integer  variables  and  not  constants.  The 
variable  names  mentioned  atove  may  be  changed  but  their  order  must  remain 
unchanged.  Within  your  program  they  can  have  other  names. 

The  first  variable  in  this  example,  called  INTNR%,  is  the  number  of  the  interrupt 
you  want  to  call.  Be  careful  to  specify  the  exact  interrupt  number.  Also,  avoid 
passing  a  variable  which  has  not  been  initialized.  Otherwise,  you  may  call  the 
wrong  interrupt,  which  could  lead  to  a  system  crash.  The  variables  following 
INTNR%  are  copied  into  the  processor  registers  of  the  same  names.  If  a  register  is 
not  used  by  an  interrupt  routine,  you  can  pass  any  integer  variable  in  the 
corresponding  register  variable.  The  v^ue  of  the  ES  register  is  treated  differently.  If 
the  v^ue  of  ES%  is  -1,  the  contents  of  the  DS  register  is  copied  to  the  ES 
register. 

Following  the  completion  of  the  interrupt  call,  the  values  are  returned  in  the 
designated  register  variables. 

This  technique  works  only  with  half  registers  (AH,  AL,  BH...).  It  may  be 
necessary  to  transform  these  half  registers  into  a  whole  register.  This  can  be  done 
as  follows: 

300  AX%  =  AH%  *  256  +  AL% 

On  the  other  hand,  a  whole  register  can  be  split  into  two  half  registers  with  the 
following  commands: 

410  AH%  =  INT(AX%  /  256) 

420  AL%  =  AX%  AND  255 

After  calling  interrupt  functions,  the  carry  flag  in  the  flag  register  indicates  if  the 
called  functions  were  executed  correctly.  In  a  BASIC  program,  it  may  be  necessary 
to  test  the  carry  or  zero  flags.  Since  the  content  of  the  flag  register  is  in  the 
variable  FLAGS  %  after  the  interrupt  call,  the  status  of  individual  flags  can  be 
inspected  through  this  variable.  This  is  possible  with  the  following  program 
statements: 
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200  IF  FLAGS%  AND  1=0  THEN  PRINT  "CARRY-FLAG  OFF"  ELSE 
PRINT  "CARRY-FLAG  SET" 

210  IF  FLAGS%  AND  64=0  THEN  PRINT  "ZERO-FLAG  OFF"  ELSE 
PRINT  "ZERO-FLAG  SET" 


Another  problem  with  interrupt  calling  is  passing  variable  addresses  (e.g.,  character 
string  output).  BASIC  stores  this  set  of  characters  as  a  string.  To  determine  the 
offset  address  of  such  a  string  (the  segment  address  of  all  variables  is  constant),  use 
the  VARPTR  function.  The  LO  and  HI  byte  of  the  offset  address  can  be  determined 
with  the  following  two  program  lines: 

300  LO=PEEK (VARPTR (STRING_NAME) +1)  ' LO-Byte  of  the  Offset  address 
310  HI=PEEK (VARPTR (STRING_NAME) +2)  'HI-Byte  of  the  Offset  address 

Garbage  collection 

These  addresses  should  be  determined  at  the  beginning  of  a  BASIC  program  as  well 
as  immediately  before  each  interrupt  call,  since  BASIC  frequently  performs  garbage 
collection  (removing  unused  variables  and  junk  data).  Garbage  collection  frees  up 
variable  memory,  rearranges  remaining  data  in  memory  and  changes  addresses.  If  a 
string  address  is  determined  at  the  beginning  of  a  program,  it  may  change  several 
times  before  the  interrupt  call  is  made. 

Remember  to  include  an  end  marker  (“$”  or  a  CHR$(0))  at  the  end  of  the  string 
(BIOS  and  DOS  functions  expect  one  of  these). 


Note:  Before  copying  this  subroutine  and  trying  it,  we  have  a  small 

suggestion.  During  your  first  attempts  something  will  probably  go 
wrong.  This  is  perfectly  normal,  and  you  can  even  expect  the 
computer  to  crash  a  couple  of  times.  Save  programs 
frequently... especially  before  running  the  program.  This  way,  you 
won’t  have  to  type  in  the  program  again  from  the  beginning. 


Here  is  a  short  sample  program  which  uses  the  subroutine  described  above  to 
display  text  on  the  screen  with  function  9  of  interrupt  21H. 


100 

110 

120 

130 

140 

150 

160 

170 

180 

190 

200 

210 

220 

230 

235 

240 

250 

260 

270 

280 

290 


^■k-kifkifk-k-k-k-klfk 


***★****★*★★***★★*★ 
I  N  T  D  0  S  B 


k***************** 


Assignment 


Author 
developed 
last  Update 


:  outputs  as  an  example  of  an  Interrupt 
a  String  through  a  DOS  function  on 
the  display  screen 
:  MICHAEL  TISCHER 
:  07/30/87 
:  04/08/89 


★  ★  *  ★ 


CLS  :  KEY  OFF 

PRINT"NOTE:  This  program  can  only  be  started  if  the  GWBASIC  was  " 
PRINT"started  from  the  DOS  level  with  the  command  " 

PRINT"<GWBASIC  /m:60000>." 

PRINT  :  PRINT"If  this  is  not  the  case,  please  input  <s>  for  Stop." 
PRINT"Otherwise  press  any  key..."; 

A$  =  INKEY$  :  IF  A$  =  "s"  THEN  END 

IF  A$  =  ""  THEN  260 

PRINT 

GOSUB  60000  'install  function  for  interrupt  call 
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300  T$  =  CHR$(13)  +  CHR$(10)  +  -this  text  was  output  through  - 
305  T$  =  T$  +  -Function  9  of  Interrupt  21H _ $" 

310  INR%  “  &H21  'Number  of  interrupt  to  be  called 

320  FKT%  «  9  'Number  of  functions  to  be  called 

330  OFSLO%  -  PEEK(VARPTR(T$)+1)  'LO-Byte  Offset  address  to  the  String 
340  OFSHI%  =  PEEK(VARPTR(T$)+2)  'HI-Byte  Offset  address  to  the  String 
350  CALL  IA(INR%,FKT%,Z%,Z%,Z%,Z%,Z%,OFSHI%,OFSLO%,Z%,  Z%,Z%,Z%) 

360  PRINT  :  PRINT  :  PRINT  'output  three  blank  lines 

370  END 
380  ' 

60000  ***************************************************************** 

60010  '*  initialize  the  routine  for  the  interrupt  call  *' 

60020  '* - *• 

60030  '*  Input  :  none  *' 

60040  '*  Output:  lA  is  the  Start  address  of  the  Interrupt  routine  *' 

60050  ***************************************************************** 

60060  • 

60070  IA=60000!  'Start  address  of  the  routine  in  the  BASIC  segment 

60080  DEF  SEG  'set  BASIC  segment 

60090  RESTORE  60130 

60100  FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'poke  Routine 
60110  RETURN  'back  to  caller 

60120  ' 

60130  DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

60140  DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

60150  DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

60160  DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 

60170  DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 

60180  DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

60190  DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

60200  DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

60210  DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

60220  DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

60230  DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 

How  it  works 

The  program  is  composed  of  separate  parts.  Lines  210-290  call  the  subroutine  to 
initialize  the  machine  language  function  for  the  interrupt  call.  Then  the  individual 
variables  for  the  interrupt  call  are  loaded.  T$  accepts  the  string  to  be  output. 
CHR$(13)  and  CHR$(10)  print  a  blank  line  before  the  output  of  the  actual  text 
This  text  ends  with  the  “$”  character  because  the  DOS  function  which  outputs  the 
string  expects  this  character  as  an  end  marker  (it  will  not  display  this  character). 
INR%  and  FKT%  contain  the  interrupt  number  and  the  function  number  to  be 
called.  Besides  these  two  variables,  the  variables  OFSLO%  and  OFSHI%  contain 
the  offset  address  of  T$. 

The  CALL  command  (line  350)  calls  the  interrupt.  The  first  variable  passed  is 
INR%  with  the  number  of  the  interrupt  to  be  called.  Then  follows  FKT%,  which 
transfers  to  the  AH  register  before  the  interrupt  call  and  informs  interrupt  21H  of 
the  function  number  to  be  called.  Several  Z%  variables  follow.  These  act  as 
dummy  variables  for  all  registers  which  have  no  special  significance  to  the 
function  which  is  called.  The  content  of  Z%  is  unimportant.  The  content  of  the 
register  into  which  it  is  copied  is  irrelevant  for  the  called  function.  After  the  Z% 
variables,  which  determine  the  contents  of  the  AL,  BH,  BL,  CH  and  CL  registers, 
follow  the  variables  OFSHI%  and  OFSLO%,  which  set  the  offset  address  of  the 
string  in  the  DX  register.  The  remaining  register  contents  are  unimportant  for  the 
function  call  and  are  filled  with  Z%. 
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To  permit  the  DOS  function  which  is  called  to  output  the  text,  its  offset  and 
segment  address  must  be  known.  This  address  is  expected  in  the  DS  register  and 
will  be  set  automatically  by  GW-BASIC. 

To  conclude  this  section,  here  is  the  listing  of  the  assembler  program  that  we  just 
used  to  call  an  interrupt. 

.************★********************************************************** 

;*  BASINT.ASM:  This  routine  offers  the  capability  of  * 

;*  calling  any  interrupt  from  BASICA  or  * 

; *  GWBASIC  * 

.  *  * 

•  ** _ ★* 

;*  Call:  * 

;*  CALL  ADR(INTNR%,AH%,AL%,BH%,BL%,CH%,CL%,DH%,DL%,DI%,SI%,ES%,FLAGS%)  * 

.  ** _ ** 

;*  On  passing  control  to  the  machine  language  program  BASIC  * 

;*  deposits  the  variables  on  the  following  positions  of  the  stack  * 


★ 

INTNR% 

=  SP+30 

AH%  =  SP+28 

AL% 

=  SP+26 

BH% 

=  SP+24 

* 

★ 

BL% 

=  SP+22 

CH%  =  SP+20 

CL% 

=  SP+18 

DH% 

=  SP+16 

* 

★ 

DL% 

=  SP+14 

DI%  =  SP+12 

SI% 

=  SP+10 

ES% 

=  SP+8 

* 

★ 

FLAGS% 

=  SP+6 

* 

k 

★ 

for  ES 

the  value  -1  is  passed. 

then  ES 

is  set  to 

DS 

k-kit-kifkiti 

k-k*  k-kkk* 

k*k****k*-kk-kk*k*-k**k-k-k**-k 

**★★★★**★★★ 

kkk  1 

code  segment 


assume  cs : code, ds: code, es: code, ss:code 
; —  the  Routine  for  Interrupt  call  - 


basint  proc  far 


;GW  expected  during  CALL  far  procedure 


push  bp 
mov  bp, sp 
push  ds 
push  es 


;GW  base  pointer  saved 
/Send  SP  to  BP 
;GW  dta  segment  stored 
; GW  extra  segment  saved 


mov  si, [bp+30] 
mov  ax, [si] 
call  set  intnr 


/Get  address  of  variable  INTNR 
/Move  content  of  this  variable  to  AX 
/Store  interrupt  number 


ad  1  label  near 


/Address  for  SET_INTNR 


mov 

si, [bp+12] 

/Get  address  of  DI%  variables 

mov 

di, [si] 

/Move  content  of  variables  to  DI 

mov 

si, [bp+8] 

/Get  address  of  variable  ES% 

mov 

ax, [si ] 

/Move  content  of  variable  to 

AX 

cmp 

ax,-l 

/was  -1  passed? 

jne 

setes 

/No  — >  set  ES 

mov 

ax,ds 

/Set  AX  to  DS  and  thereby  ES 

=  DS 

mov 

es,  ax 

/transfer  AX  to  ES 

mov 

si, [bp+28] 

/Get  address  of  variable  AH% 

mov 

ah, [si] 

/Move  content  of  variable  to 

AH 

mov 

si, [bp+26] 

/Get  address  of  variable  AL% 

mov 

al,  [si] 

/Move  content  of  variable  to 

AL 

mov 

si, [bp+24] 

/Get  address  of  variable  BH% 

mov 

bh, [si] 

/Move  content  of  variable  to 

BH 

mov 

si,  [bp+22] 

/Get  address  of  variable  BL% 

mov 

bl, [si] 

/Move  content  of  variable  to 

BL 

mov 

si,  [bp+20] 

/Get  address  of  variable  CH% 

mov 

ch, [si] 

/Move  content  of  variable  to 

CH 

mov 

si, [bp+18] 

/Get  address  of  variable  CIA 

mov 

cl, [si] 

/Move  content  of  variable  to 

CL 
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mov 

si, [bp+16] 

/Get  address  of  variable  DH% 

mov 

dh, [si] 

/Move  content  of  variable  to  DH 

mov 

si, [bp+14] 

/Get  address  of  variable  DL% 

mov 

cil,[si] 

/Move  content  of  variable  to  DL 

mov 

si,  [bp+10] 

/Get  address  of  variable  SI% 

mov 

si, [si] 

/Move  content  of  variable  to  SI 

push  bp 

/Store  base  pointer 

label  near 

/Address  for  SET_INTNR 

int 

21h 

/Call  interrupt 

pop 

bp 

/Replace  base  pointer 

push  si 

/Store  SI 

pushf 

/Store  flag  register 

mov 

si,  [bp+12] 

/Get  address  of  variable  DI% 

mov 

[si],di 

/Ffove  content  of  variable  to  DI 

mov 

si, [bp+28] 

/Get  address  of  variable  AH% 

mov 

[si], ah 

/Store  AH  in  this  variable 

mov 

si, [bp+26] 

/Get  address  of  variable  AL% 

mov 

[si],al 

/Store  AL  in  this  variable 

mov 

si, [bp+24] 

/Get  address  of  variable  BH% 

mov 

[si],bh 

/Store  BH  in  this  variable 

mov 

si, [bp+22] 

/Get  address  of  variable  BL% 

mov 

[si],bl 

/Store  BL  in  this  variable 

mov 

si, [bp+20] 

/Get  address  of  variable  CH% 

mov 

[si],ch 

/Store  CH  in  this  variable 

mov 

si,  [bp+18] 

/Get  address  of  variable  CL% 

mov 

[si],  cl 

/Store  CL  in  this  variable 

mov 

si,  [bp+16] 

/Get  address  of  variable  DH% 

mov 

[si],dh 

/Store  DH  in  this  variable 

mov 

si, [bp+14] 

/Get  address  of  variable  DL% 

mov 

[si],dl 

/Store  DL  in  this  variable 

mov 

si, [bp+8] 

/Get  address  of  variable  ES% 

mov 

ax,es 

/transfer  ES  to  AX 

mov 

[si], ax 

/Store  ES  (AX)  in  this  variable 

pop 

ax 

/Move  flag  register  from  stack  to  AX 

mov 

si,  [bp+6] 

/Get  address  of  variable  FLAGS% 

mov 

[si] ,ax 

/Store  FLAGS  in  this  variable 

pop 

ax 

/Move  DI  register  from  stack  to  AX 

mov 

si,  [bp+10] 

/Get  address  of  variable  SI% 

mov 

[si], ax 

/Store  SI  (AX)  in  this  variable 

pop 

es 

/Get  GW  extra  segment  back 

pop 

ds 

/Get  GW  data  segment  back 

pop 

bp 

/Return  GW  base  pointer 

ret 

26 

/Addresses  of  variables  on  the  stack 

;are  no  longer  needed 


basint  endp 


set_intnr  proc  near  /stores  the  interrupt  number 

pop  bx 

mov  cs ; [bx+ad_2-ad_l+l ] , al 
jmp  ad__l 

set_intnr  endp 


code  ends 

end 
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Some  brief  notes  on  this  program  follow  for  those  not  familiar  with  the  calling 
and  linking  of  assembly  language  programs  in  GW-BASIC:  The  program  first 
pushes  the  base  pointer  on  the  stack  since  it  will  be  reset  by  the  next  instruction. 
During  re-entry  into  GW-BASIC,  the  base  pointer  must  have  the  value  it  had 
during  the  call  of  the  routine.  Then  the  base  pointer  is  set  to  the  value  of  the  stack 
pointer  for  access  to  data  on  the  stack.  This  is  necessary  for  GW-BASIC  to  pass 
the  BASIC  variables  named  in  the  CALL  command  to  the  stack.  In  the  next  step, 
the  DS  and  the  ES  registers  are  stored  on  the  stack,  because  their  content  may 
change  during  execution  of  the  routine  and  must  be  preserved  for  return  to  GW- 
BASIC. 

Now  the  routine  can  read  in  the  variables  and  set  the  various  processor  registers.  It 
is  important  to  note  that  the  stack  does  not  contain  variable  contents,  but  their 
addresses  relative  to  the  DS  register.  Because  of  this,  the  address  of  the  variable 
must  be  loaded  Erst  and  then  the  relative  value  of  this  address. 

Which  addresses  contain  the  addresses  of  the  individual  variables  stored  on  the  stack 
can  be  determined  from  the  header  of  the  assembly  language  routine.  First  you 
must  determine  the  number  of  the  interrupt  to  be  called.  This  value  must  be  treated 
in  a  different  manner  than  the  other  variables  on  the  stack  because  it  isn’t  passed  in 
one  of  the  processor  registers,  but  is  a  part  of  the  INT  instruction  which  calls  the 
interrupt.  It  is  indicated  as  a  byte  following  the  code  of  the  INT  instruction  (CDH). 

To  set  the  interrupt  number,  the  number  to  be  passed  must  be  stored  following  the 
CDH  code  of  the  INT  instruction.  This  creates  a  small  problem  since  this  routine 
can  be  POKEd  by  the  BASIC  program  into  any  memory  location.  Because  of  this, 
the  address  of  the  INT  instruction  depends  on  the  current  starting  address  of  the 
routine  instead  of  remaining  constant.  The  routine  doesn’t  know  where  the  INT 
instruction  is  located. 

A  small  trick  can  be  used  to  help  here.  The  routine  does  not  know  where  it  is 
stored,  but  the  processor  knows  the  location  of  the  INT  instruction  (it  has  to 
know,  otherwise  it  couldn’t  execute  the  routine).  The  subroutine  SET__INTR  is 
called  after  the  interrupt  number  is  loaded  into  the  AX  register.  The  processor,  as 
in  any  CALL  instruction,  stores  the  address  where  the  program  execution  is  to 
continue  on  the  stack,  before  calling  any  subroutine.  This  is  the  instruction  which 
precedes  the  label  AD_1. 

Subroutine  SET__INTR  gets  the  address  of  AD_1  from  the  stack.  While  the  address 
of  the  INT  instruction  is  still  not  known,  the  distance  between  AD_1  and  the  INT 
instruction  remain  constant,  the  address  of  the  INT  instruction  can  be  calculated 
and  the  interrupt  number  can  be  stored  following  the  instruction.  The  task  ends  and 
the  routine  returns  to  the  main  iM*ogram  (to  the  label  AD__1). 

The  rest  of  the  routine  consists  of  repeating  instructions  which  determine  the 
contents  of  the  different  variables  and  pass  them  to  the  corresponding  processor 
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registers.  The  value  fOT  the  ES  register  is  given  a  special  test:  if  it  is  equal  to  -1, 
the  value  of  the  DS  register  is  copied  to  the  ES  register. 

After  all  registers  are  loaded,  the  interrupt  is  called  and  the  contents  of  the 
processor  registers  are  transferred  back  to  the  corresponding  BASIC  variables.  The 
last  step  is  to  restore  the  contents  of  all  registers  which  had  been  saved  on  the 
stack.  Finally  control  returns  to  GW-BASIC. 
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4.2  Interrupt  Calls  from  Turbo  Pascal 

Calling  interrupts  from  Turbo  Pascal  is  very  easy.  Throughout  this  book  well  be 
using  Turbo  Pascal  Version  4.0. 

INTR 


Turbo  Pascal  uses  the  INTR  procedure.  Since  this  parameter  can  accept  any  value 
between  0  and  255,  all  available  interrupts  can  be  called. 

MSDOS 

A  special  form  of  this  INTR  procedure  is  the  MSDOS  procedure.  It  is  called  in  a 
manner  similar  to  INTR: 

MsDos  (  Regs: Registers  ); 

The  IntemiptNumber  parameter  needed  by  Turbo  Pascal  Version  3.0  isn’t  required 
in  this  procedure  since  it  always  calls  interrupt  21H,  through  which  almost  all 
operating  system  functions  can  be  called. 

In  both  procedures,  the  parameter  register  is  a  record  type  which  holds  the  contents 
of  the  registers  to  be  passed.  These  are  copied  into  the  registers  before  the  interrupt 
call. 

The  DOS  unit  contains  the  parameters  for  the  type  called  Registers: 

type  Registers  =  record 
case  integer  of 

0  :  (AX,  BX,  CX,  DX,  BP,  SI,  DI,  DS,  ES,  Flags  :  word) ; 

1  :  (AL,  AH,  BL,  BH,  CL,  CH,  DL,  DH  :  byte) ; 
end; 


Once  the  DOS  unit  has  been  included  in  a  Turbo  Pascal  source  code,  the  var 
statement  can  be  used  to  define  the  register  variables  under  the  name  Regs: 

var  Regs  :  Registers; 


Now  Turbo  Pascal  can  easily  communicate  with  the  following  processor  registers: 

•  Regs. ax, 

•  Regs.bx, 

•  Regs.cx, 

•  Regs. ah,  etc. 


You  then  pass  the  values  to  the  registers  through  standard  assignments.  For 
example: 

Register. ax  :=  254; 


The  same  method  is  used  with  all  other  registers. 
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Unfortunately,  the  contents  of  the  half  registers  AH,  AL,  BL,  etc.  can’t  be  defined 
this  way.  In  this  case,  a  trick  can  be  used  by  defining  the  half  registers  as  normal 
integer  or  byte  variables  and  then  merging  them  togeth^  into  a  whole  register. 

In  the  case  of  the  AX  register,  this  could  be  done  as  follows: 

var  al, 

ah  :  integer; 

Register. ax  ah  shl  8  +  al; 


In  this  statement,  the  AX  register  is  assigned  value  composed  of  the  sum  of  the 
AH  register  multiplied  by  256  (shifting  a  variable  left  by  8  places  is  equivalent  to 
multiplying  it  by  256)  and  the  AL  register. 

If  you  must  do  this  repeatedly  in  a  program,  it  would  be  useful  to  define  a  small 
function  for  this: 

function  WholeRegister (Lo,  Hi  ;  integer)  :  integer; 
begin 

WholeRegister  ;=  Lo  +  Hi  shl  8; 
end; 


Instead  of  the  above,  the  following  could  be  written: 

Register. ax  :=  WholeRegister (al,  ah); 


Before  calling  the  interrupt,  you  must  first  specify  the  interrupt  value  in  the 
register.  The  contents  of  all  other  registers  are  unimportant  here.  If  the  called 
interrupt  returns  values  to  the  calling  program  through  registers,  they  can  be 
examined  by  looking  at  the  individual  components  of  the  variable  register. 

Sometimes  individual  flags  pass  information  from  the  interrupt  to  the  calling 
program.  In  most  cases,  the  Carry  flag  serves  this  purpose.  If  an  error  occurs 
during  the  execution  of  an  interrupt,  the  flag  is  set. 

To  test  for  a  set  flag,  the  following  Pascal  statements  are  used.  They  return  TRUE 
or  FALSE  as  a  result  depending  on  whether  the  corresponding  flag  was  set  or  not. 

•  carry  flag:  (register. flags  and  1) 

•  zero  flag:  (register. flags  and  64) 

•  sign  flag:  (register. flags  and  128) 

Often  the  address  of  a  variable  (usually  a  text  buffer)  must  be  passed  to  an 
interrupt.  In  this  case  the  Turbo  functions  Ofs  and  Seg  are  used  to  obtain  the  offset 
or  segment  addresses  of  a  variable.  The  name  of  the  variable  whose  address  should 
be  determined  is  passed  to  both  functions  as  the  argument: 

ofs  (variablenaitiG) 
seg (variable name) 

Turbo  Pascal  uses  a  different  format  than  DOS  and  BIOS  for  string  storage, 
especially  for  text  buffers  (mosUy  variables  of  type  string). 
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These  formats  are  illustrated  below. 

TURBO  PASCAL 


No  end  of  string  marker 


String  iength 


DOS  &  BIOS 


BIOS  (and  often  in  DOS) 
DOS 

End  of  string  marker 
No  string  length  parameter 


String  storage  -  Turbo  Pascal  andBIOS-DOS 

To  convert  a  Turbo  Pascal  string  into  DOS  or  BIOS  format,  an  end  character 
(ASCII  code  0)  or  the  dollar  sign  (ASCII  code  36)  is  appended.  Which  of  these 
two  characters  you  should  use  for  indicating  the  end  of  the  string  is  described 
during  the  discussions  of  individual  interrupts.  Regardless  of  which  format  you 
use,  the  characters  appear  as  in  either  of  the  following  commands: 

string  :=  string+#0; 
string  :=  string+#36; 

The  address  returned  by  the  Ofs  function  plus  1  must  be  passed  to  the  interrupt, 
otherwise  the  byte  which  indicates  the  length  of  the  string  is  accepted  by  the 
interrupt  as  its  first  character. 

Here  is  the  sample  program.  Just  like  the  example  in  Section  4.1,  it  displays  text 
on  the  screen  using  function  9  of  interrupt  21H: 

I  ***★★★★***★★★  ★^Ir****-*****************************'**********************} 


{*  I  N  T  D  0  S  *} 

- ^ - - - *} 

{*  Task  :  as  an  example  this  interrupt  call  outputs  *} 

{*  a  string  through  a  function  of  DOS  on  *} 

{*  the  display  *} 

{* - - *} 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  :  07/30/87  *} 

{*  last  update  :  05/04/89  *} 


I *********************************************************★*******★****} 

program  INTDOSP; 
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Uses  Dos; 

var  Regs  :  Registers;  {  Register  variables  for  interrupt  call} 

Text  :  string[128];  {  accepts  the  output  text  } 

{*****★**************************************************************** I 

{*  MAIN  PROGRAM  *} 

^ ****** **************************************************************** j 

begin 

Text  :=  #13#10'this  text  was  output  with  Function  9  of  DOS-'+ 

•Interrupt  21H  . . . • #13#10+ ' ; 

Regs. ah  :=  $09;  {  Function  number  9  in  the  AH-Register  } 

Regs.dx  :=  Ofs(Text)+l;  {  Offset  address  of  the  text  } 

Regs.ds  :=  Seg(Text);  {  Segment  address  of  the  text  } 

MsDos(Regs);  {  Call  DOS-Interrupt  21(h)  } 

end. 


The  variable  TEXT  contains  the  text  to  be  displayed.  The  sequence  “#13#10” 
places  the  ASCII  code  13,  followed  by  ASCII  code  10,  at  the  beginning  and  the 
end  of  the  text,  creating  a  blank  line  before  and  after  the  text.  The  last  character  is 
the  “$”  character  which  indicates  the  last  character  of  text  to  DOS. 

The  number  of  the  function  being  called  (9)  is  copied  to  the  AH  register.  Since 
Turbo  Pascal  doesn’t  allow  access  to  the  AH  register  alone,  the  entire  AX  register 
must  be  addressed.  The  value  0  is  loaded  into  the  AL  register,  but  any  other  value 
could  be  entered  into  this  register  since  its  content  has  no  significance  to  the  called 
function.  As  a  last  step,  before  calling  interrupt  21H  using  the  MSDOS  procedure, 
the  segment  address  of  the  string  is  placed  in  the  DS  register  and  the  offset  address 
in  the  DX  register. 
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4.3  Interrupt  Calls  from  C 

The  C  language  is  the  language  of  choice  for  most  developers.  Since  it  was 
originally  designed  for  operating  system  development,  C  has  provisions  to  include 
machine  language  routines,  which  is  a  benefit  within  the  scqpe  of  this  book. 

The  standard  liteiries  of  both  the  Microsoft  C  and  Borland  Tuibo  C  compilers  have 
a  number  of  functions  for  calling  interrupts. 

The  following  functions  are  of  interest  to  us  in  this  book: 

•  int86 

•  int86x 

•  intdos 

•  intdosx 

•  segread 


All  functions  and  ^plicable  data  structures  are  declared  in  the  IX)S.H  file. 
A  program  which  wants  to  access  one  of  these  functions  must  therefore  link  the 
file  to  the  current  program  using  the  #include  preprocessor  command. 

The  three  structures  WORDREGS,  BYTEREGS  and  SEGREGS  pass  register 
values.  WORDREGS  contains  the  whole  registers  AX,  BX,  CX,  DX,  SI,  DI  and 
the  Carry  flag.  On  the  other  hand,  BYTEREGS  contains  the  half  registers  AH, 
AL,  BH,  BL,  CH,  CL,  DH  and  DL,  while  SEGREGS  represents  the  segment 
registers  DS,  CS,  SS  and  ES. 

The  BYTEREGS  and  the  WORDREGS  structures  are  joined  in  the  union  REGS 
which  lets  the  programmer  work  selectively  with  either  half  or  whole  registers. 

Using  a  variable  of  the  type  REGS  (called  register  here  for  simplicity’s  sake)  gives 
us  the  following: 

union  REGS  register; 

This  allows  access  to  individual  registers: 

•  AX;  register .X. ax 

•  BX;  register, x.bx  etc. 

•  AH;  register. h. ah 

•  AL;  register. h.al 

•  BH;  register. h.bh  etc. 

The  carry  flag  is  represented  by  the  variable  register.x.cflag.  If  this  variable  is  equal 
to  0,  the  carry  flag  remains  unset.  Any  other  value  sets  the  carry  flag. 

In  the  case  of  the  segment  register  a  representative  variable  can  be  defined  as 
follows: 

struct  SREGS  SegRegister; 
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The  individual  components  of  the  variables  SegRegister.ds,  SegRegister.es,  etc., 
correspond  to  the  equivalent  process^  registers. 

The  functions  starting  with  the  characters  int  all  serve  to  call  interrupts.  The 
SEGREAD  function  reads  the  current  contents  of  the  segment  register. 

The  functions  that  call  interrupts  use  different  register  variables  for  input  to  the 
interrupt  routine,  and  output  from  the  interrupt  routine.  There  is  an  advantage  to 
this  method  over  returning  information  to  the  same  register  variable  in  that  the 
input  information  is  not  overwritten. 

Since  the  individual  functions  pass  only  the  address  of  the  variable  representing  the 
register  and  not  the  variable  itself,  it  is  possible  to  combine  the  input  and  output 
registers  into  a  single  variable.  In  this  case,  the  address  of  one  variable  is  provided 
for  the  variable  representing  the  input  and  the  output  registers  (this  method  is  used 
in  the  sample  program  at  the  end  of  this  section). 

Before  calling  the  interrupt,  the  contents  of  the  input  variable  are  copied  to  the 
corresponding  processor  registers.  Following  the  interrupt  call  their  contents 
become  the  output  variables. 

All  interrupt  functions  return  the  content  of  the  AX  register  as  a  result  code  after 
the  interrupt  call. 

Here  are  the  details  of  the  functions  and  their  calls: 


int86 


The  int86  function  is  called  as  follows: 

int86 (IntNumber,  InRegister,  OutRegister) ; 

IntNumber  is  a  variable  or  constant  indicating  the  number  of  the  interrupt  to  be 
called.  InRegister  and  OutRegister  contain  the  address  of  two  (or  one)  variables  of 
the  REGS  type.  As  the  variable  name  suggests,  InRegister  contains  the  register 
contents  before  the  interrupt  call,  and  OutRegister  contains  the  register  contents 
after  the  interrupt  call. 


int86x 


The  int86x  function  differs  from  the  int86  function  in  that  it  requires  an  additional 
argument  of  the  SREGS  type.  Its  contents  are  copied  into  the  segment  register 
before  calling  the  interrupt,  but  are  not  copied  back  following  the  call  to  the 
interrupt  routine. 

The  call  of  the  function  is  as  follows: 

i nt 8 6x (IntNumber,  InRegister,  OutRegister,  SegRegister) ; 


41 


4.  Using  Interrupts  from  High  Level  Languages 


PC  System  Programming 


The  intdos  and  the  intdosx  functions  differ  from  the  two  functions  described  above, 
in  that  the  number  of  the  interrupt  to  the  call  is  not  passed.  As  the  names  suggest, 
they  call  DOS  interrupt  21H  through  which  most  DOS  functions  can  be  accessed. 


intdos 

Only  the  addresses  of  the  input  and  the  output  variables  representing  the  processor 
registers  are  passed  to  the  intdos  function: 

intdos (InRegister,  Out Register) ; 

intdosx 


The  intdosx  function,  like  the  int86x  function,  has  an  additional  parameter  for  the 
segment  register.  The  function  call  is  as  follows: 

intdosx (InRegister,  OutRegister,  SegRegister) ; 


So  far  you’ve  seen  how  to  call  an  interrupt  from  C  and  how  to  set  the  registers. 
You  also  have  to  determine  the  address  of  a  variable. 

In  C,  you  can  easily  determine  the  address  of  a  variable.  To  do  this,  use  the  address 
operator  &,  which  returns  the  offset  address  of  any  desired  variable.  Use  the 
SEGREAD  function  mentioned  above  to  determine  the  segment  address  of  a 
variable.  The  address  of  a  variable  of  the  SREG  type  is  passed  to  the  function 
(using  the  address  operator  &)  into  which  the  content  of  the  segment  register  can 
be  copied. 

If,  for  example,  the  address  of  the  variable  SegRegister  is  passed  to  the  function 
and  the  variable  was  previously  defined  by  the  command: 

union  SREG  SegRegister; 


Then  the  variable  SegRegister.ds  contains  the  segment  address  of  the  variable 
SegRegister,  after  calling  the  SEGREAD  function. 

While  C  supports  interrupt  calls  with  numerous  functions,  the  library  of  the 
Microsoft  C  compiler  library  does  not  have  a  function  to  return  the  contents  of  a 
memory  location.  Since  such  a  function  could  be  very  valuable  in  some  programs, 
the  assembler  program  below  contains  the  PEEKS  and  POKES  functions  for 
inclusion  in  programs  created  with  the  Microsoft  C  compiler.  PEEK  returns  the 
contents  of  a  memory  location  (one  byte),  while  the  POKE  function  writes  a  one- 
byte  value  into  a  memory  location. 

Note:  If  you  use  the  Sorland  Turbo  C  compiler,  you  won’t  need  to  use  this 

program  since  the  Turbo  C  library  already  contains  the  PEEK, 
PEEKE,  POKE  and  POKES  functions.  Eecause  of  this,  linking  the 
assembler  program  into  the  C  example  programs  of  this  book  is 
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unnecessary.  Additional  information  is  presented  in  the  header  of  each 
program. 

If  you  are  using  the  Microsoft  C  compiler,  enter  the  following  program  with  a  text 
editor  and  save  it  under  the  name  PETO.  ASM.  It  can  then  be  assembled  with: 

masm  pepo; 

Here’s  the  program: 


* -k-k-klt-klc-klcic*******  ****************************************************  • 


•  * 

PEPO 

.  ★ 

.  * 

.  * _ 

Task 

:  Makes  the  PEEKS  and  POKES 
inclusion  in  a  C  program 

function  available  for 

.  ★ 

Author 

:  MICHAEL  TISCHER 

.  * 

developed 

:  08/13/87 

.  * _ 

last  Update 

:  04/08/89 

assemble  :  MASM  PEPO; 


********************************************************************** 


IGROUP  group  _text  ; Grouping  of  program  segments 


DGROUP 

group  const, _bss,  i 

assume  CS: IGROUP,  DS 

public  _PeekB 
public  _PokeB 

data 
:  DGROUP, 

; Grouping  of  data  segments 

ES: DGROUP,  SS: DGROUP 

/Functions  become  accessible  to 
/other  programs 

CONST 

CONST 

segment 

ends 

word  public 

•CONST' 

/this  segment  accepts  all  constants 
/which  are  readable 

BSS 

_BSS 

segment 

ends 

word  public 

•BSS* 

/this  segment  accepts  all  non- 
; initialized  static  variables 

_DATA 

_DATA 

segment 

ends 

word  public 

•DATA' 

/all  initialized  global  and 
/static  variables  are  stored  in  this 
; segment 

_TEXT 

segment 

byte  public 

'  CODE  • 

/the  Program  segment 

7 —  PEEKS:  read  a  byte  from  memory  - 

; —  call  of  C:  int  =  Pee)cB(int  Segment,  int  Offset) 

_PeekB  proc  near 

push  bp 
mov  bp, sp 
push  ds 
mov  ax,  [bp]  +4 
mov  ds, ax 
mov  bx, [bp] +6 
mov  al,  [bx] 
xor  ah, ah 
jmp  short  fctend 

_PeekB  endp 

; —  POKES:  write  a  byte  into  memory  - 

; —  Call  C:  PokeB(int  Segment,  int  Offset,  short  int  Wert) 

_PokeB  proc  near 

push  bp  ; store  BP  on  the  stack 

mov  bp,  sp  ;transmit  SP  to  BP 


; store  BP  on  the  stack 
; transmit  SP  to  BP 
; store  data  segment  register 
;get  first  argument  (Segment) 
;set  as  data  segment 
;get  second  argument  (Offset) 
;read  memory  location 
;HI-byte  of  INT  to  0 
; terminate  function 
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push 

ds 

; store  data  segment  register 

mov 

ax, [bp] +4 

;Get  first  argument  (Segment) 

mov 

ds,ax 

;Set  as  data  segment 

mov 

bx, [bp] +6 

;Get  second  argument  (Offset) 

mov 

al, [bp] +8 

;Get  third  argument  (Value) 

mov 

[bx],al 

; write  into  memory  location 

fctend: 

pop 

ds 

; Return  data  segment  register 

mov 

sp,bp 

; Restore  stack  pointer 

_PokeB 

pop 

ret 

endp 

bp 

;Get  BP  from  stack 
; Return  to  calling  C  program 

_text 

ends 

end 

;End  of  the  program  segment 
;End  of  the  assembler  source 

The  example  program  below  uses  the  two  functions  described  above.  This  next 
program  examines  the  model  identification  number  or  code  of  the  PC  and  displays 
PC  type  on  the  screen  using  a  DOS  function: 


/***★****★*★ *************************************************** *★****★★/ 
/*  I  N  T  D  0  S  */ 


/* - */ 

/*  Task  :  an  exaitiple  of  an  interrupt  call,  outputs  */ 
/*  a  string  through  a  DOS  function  on  */ 
/*  the  display  screen  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 
/*  developed  :  08/30/87  */ 
/*  last  update  :  04/08/89  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 
/*  Creation  :  MSC  INTDOSC  */ 
/*  LINK  INTDOSC  PEPO;  */ 
/*  Call  :  INTDOSC  */ 
/* - */ 


/*  (BORLAND  TURBO  C  v2.0)  */ 
/*  Creation  :  through  the  RUN  command  in  the  menu... or...  */ 
/*  tcc  -K  intdosc  */ 
/*  Call  :  intdosc  */ 
/************ **********************************************************/ 


linclude  <dos,h>  /*  include  header  file  */ 
/*  Microsoft  C  user  must  uncomment  the  following  line  */ 
/*  extern  short  int  peekbO;  /*  PEEKS  must  be  linked  to  */ 
/*  Microsoft  C  object  code  */ 
/**★***★***************************************************************/ 
/**  MAIN  PROGRAM  **/ 
/***********************************************★**********************/ 


void  mainO 

{ 

static  char  AT[]  =  "NrXnthis  computer  is  an  ATXrXnS**; 

static  char  XT[]  =  "XrNnthis  computer  is  an  XTXrNnS**; 

static  char  PC[]  =  •'XrXnthis  computer  is  an  PCXrXnS**; 

union  REGS  Register;  /*  Register  variable  for  interrupt  call  */ 

Register. h. ah  =  9;  /*  Function  number  for  output  of  string  */ 

switch  (peekb(0xF000,  OxFFFE))  /*  detect  model  of  PC  */ 

{ 

case  OxFE  :  Register. x.dx  =  (int)  XT;  /*  Address  of  XT  text  */ 

break; 
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case  OxFC  :  Register. x.dx  =  (int)  AT;  /*  Address  of  AT  text  */ 

break; 

case  OxFF  : 

default  :  Register. x.dx  =  (int)  PC;  /*  Address  of  PC  text  */ 

} 

intdos (^Register,  ^Register);  /*  Call  DOS  Interrupt  21H  */ 

} 

The  main  function  defines  three  CHAR  pointers  which  point  to  the  text  for  each 
PC  type.  Each  of  them  starts  and  ends  with  an  ‘^n”  character.  This  creates  a  blank 
line  before  and  after  the  text  itself. 

In  the  first  instruction  of  the  main  program  the  AH  register  is  loaded  with  the 
DOS  function  number  for  string  output  on  the  screen.  Then  the  model 
identification  byte  is  read  from  memory  location  F000:FFFE  using  the  PEEKS 
function.  Depending  on  the  value  read,  the  offset  address  of  the  accompanying  text 
is  transferred  to  the  DX  register  where  it  is  expected  by  the  interrupt  21H  function. 

In  addition  to  this  offset  address,  the  function  also  requires  the  segment  address  of 
the  text  in  the  DS  register.  Since  the  compiler  automatically  sets  this  register,  you 
don’t  have  to  be  concerned  with  the  segment  address.  The  last  instruction  of  the 
program  calls  the  INTDOS  function  which  in  turn  calls  interrupt  21H  with  the 
registers  which  were  defined  earlier. 

The  file  header  states  how  it  can  be  executed:  If  you  are  using  the  Microsoft  C 
computer,  then  it  is  important  that  you  link  the  file  with  the  previously  assembled 
PEPO  program  so  that  the  new  program  contains  the  PEEKB  and  POKED 
functions.  These  can  then  be  called  from  the  C  program. 

The  integrated  environment  of  the  Turbo  C  compiler  requires  a  different  procedure. 
Compiler  options  must  be  set  to  default  values  except  for  under  "code  generation." 
You  must  set  "default  char  type"  to  "unsigned",  then  select  Run  from  the  menu. 
The  options  file  appears  on  the  disk  under  the  filename  INTBSPC.TC. 

A  small  comment  about  using  Borland  Turbo  C  compiler.  Several  programs  in 
this  book  include  assembly  language  routines  within  the  programs.  Since  Turbo  C 
differentiates  between  upper  and  lowercase  characters  in  function  names,  you  may 
have  problems  compiling  programs  as  entered  from  this  book.  To  avoid  this, 
select  the  OPTION  command,  then  the  LINKER  command  in  the  command  line  of 
Turbo  C  before  creating  a  program.  The  lowest  line  in  the  window  displays  the 
option  “Case  sensitive  link”.  Select  OFF  here  to  avoid  difficulties  with  upper  and 
lowercase  letters. 
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Unlike  programmers  using  any  of  the  higher  level  languages,  the  assembly 
language  programmer  doesn’t  have  to  rely  on  complicated  functions  or  procedures 
to  call  an  interrupt.  The  MOV  instruction  loads  the  input  parameters  into  the 
registers  provided,  and  the  INT  instruction  calls  the  interrupt. 

Certain  interrupts,  or  the  functions  hidden  behind  these  interrupts,  are  called 
frequently  in  many  programs.  An  example  of  this  is  interrupt  21H  function  9, 
which  displays  text  on  the  screen.  You  call  it  by  placing  function  number  9  in  the 
AH  register  and  the  offset  address  of  the  text  you  want  displayed  in  the  DX 
register.  This  process  looks  like  this  in  assembly  language: 

mov  ah, 9  /load  function  number  9 

mov  dx, offset  Text  /load  offset  address  of  text 
int  21h  /call  DOS  interrupt  21h 

Even  if  you  call  the  function  very  frequendy,  it  doesn’t  pay  to  write  a  subroutine 
for  it  since  the  address  of  the  text  to  be  displayed  must  be  passed.  All  that  remains 
is  to  load  the  value  9  into  the  AH  register  and  to  call  the  interrupt.  You’ll  find  the 
three  program  lines  described  above  included  for  every  function  call  in  a  program  in 
this  chapter. 
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5.1  Using  Assembler  Macro  Functions 

An  alternative  to  this  method  are  macros  which  most  assemblers  support. 

Macros 


A  macro  is  a  “shorthand”  way  to  write  a  series  of  assembly  language  instructions. 
It  has  a  name  and  may  have  one  or  more  parameters.  During  assembly,  if  the 
macro  name  is  encountered,  the  series  of  instructions  and  parameters  replace  the 
macro. 

Below  is  an  example  of  defining  and  calling  a  macro  using  the  Microsoft 
Assembler  (MASM).  See  your  assembler’s  reference  manual  for  information  on 
macro  handling  (and  whether  your  assembler  supports  macros).  Since  this  macro 
displays  text,  we’ve  named  the  macro  PRINT: 

print  macro  string  ;Macro  header  with  Name  and  Parameter 

mov  ah, 9  ;load  function  9 

mov  dx, offset  string  ;load  offset  address  of  the  text 

int  21h  ;call  DOS  interrupt  21h 

endm  ;the  endm  command  terminates  a  macro 

The  first  line  declares  the  macro  name  (PRINT).  In  this  case,  the  macro  also  has 
one  parameter  (string).  The  assembly  language  instructions  follow  in  successive 
lines  until  the  ENDM  instruction  terminates  the  macro. 

Now  you  can  use  the  macro  to  display  text; 

print  Message 


In  this  example.  Message  is  the  name  of  a  variable  containing  the  text  to  be 
displayed.  In  the  macro  declaration,  string  is  a  parameter.  During  assembly,  string 
is  replaced  by  Message  and  creates  the  following  {Hogram  lines: 


mov  ah, 9 

mov  dx, offset  Message 
int  21h 
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5.2  A  Sample  Macro 

The  following  program  demonstrates  the  macro  just  described. 


.********************************************************************* 


.  ★ 

MACRO 

★  > 
t 

_ ★  • 

.  ★ 

9 

Task 

:  in  this  Program  a  Macro  is  used  for  output 

it  • 

•  ★ 

9 

of  a  String  with  Function  9  of  Interrupt  21H 

★  • 

•  ★ 

9 

Author 

:  MICHAEL  TISCHER 

/ 

•  * 

developed 

:  08/30/87 

*  • 

•  it 

9 

m  * _ 

last  Update 

:  04/08/89 

* . 
t 

_ * . 

.  * 

assembly 

:  MASM  MACRO/ 

t 

★ . 

•  ★ 

•  *  — 

:  LINK  MACRO/ 

*; 

_ ★ . 

•  ★ 

9 

Call: 

:  MACRO 

t 

★  • 

.*★★*********★***★*******★***************************★*★*★★******★**** 


;*=  Macro  »»»»»=*«-»*=«**«»««=»=»= 
Print  macro  String 
mov  ah, 9 

mov  dx, offset  String 
int  21h 

endm 

;==  Constants  ==================== 

CR  equ  13 

LF  equ  10 

TEND  equ  -$'• 


;this  is  the  macro 

;load  function  number 
;load  offset  address  of  text 
/call  DOS  interrupt 

/End  of  macro 


/ASCII-Code  of  carriage  return 
/ASCI I -Code  of  linefeed 
/End  of  a  character  string 


Data  segment 

Text  db  CR, LF, "This  is  how  MACROS  are  used", CR,LF, TEND 

Data  ends 

/==  stack  ================================================== 

stack  segment  STACK 

dw  64  dup  (?) 


stack  ends 

Program  segment 

assume  CS: Program, 

Start  proc  far 

mov  ax, Data 
mov  ds,ax 

Print  Text 

mov  ax, 4C00h 
int  21h 


DS:  Data,  SS: stack 

/program  starts  here 
/set  data  segment  register 

/Macro  inserted  here 

/Program  terminated  with  call  of  a 
/DOS  function  with  return  of  error-code  0 
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start  endp 


;End  of  procedure 


Program  ends 

end  Start  ; begin  with  START 

After  you  enter  the  source  program,  it  can  be  assembled,  linked  and  executed  as 
indicated  in  the  header. 

Most  of  the  lines  in  this  listing  have  nothing  to  do  with  the  actual  program  but 
are  definitions  and  declarations  for  the  assembler. 

The  macro  and  constants  are  defined  in  the  first  part  of  the  program,  which  helps  to 
make  the  listing  more  understandable  to  the  reader.  The  definition  of  the  data 
segment  follows,  where  the  string  to  be  displayed  is  stored  as  a  character  string.  It 
is  preceded  and  followed  by  a  carriage  return  and  a  linefeed  to  display  a  blank  line 
before  and  after  the  actual  text.  The  text  ends  with  the  character  **$”  (the  DOS 
function  used  for  text  display  always  looks  for  this  as  the  last  character  in  a 
string). 

Following  the  data  segment  is  the  stack  segment,  which  controls  the  stack  during 
program  execution.  Since  the  program  is  not  very  large,  the  stack  can  be  fairly 
small.  The  last  segment  is  the  code  segment  which  contains  the  program 
instructions.  It  consists  of  only  five  commands:  The  first  two  instructions 
initialize  the  program.  They  load  the  segment  address  of  the  data  segment  into  the 
DS  register  to  provide  access  to  the  text  in  this  segment  Then  the  macro  PRINT 
is  called,  and  the  text  is  passed  to  it. 

The  following  instructions  terminate  the  program  by  calling  a  DOS  function. 

Note:  You  may  find  it  useful  to  group  together  certain  macros  into  a  file  or 

library.  When  one  of  these  macros  will  be  used  in  a  program,  the 
library  may  be  linked  or  included  with  the  assembly  language  code. 
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The  following  chapter  discusses  the  PC’s  operating  system,  which  the  PC  loads 
from  floppy  diskette  or  hard  disk.  It  is  commonly  referred  to  as  PC-DOS,  MS- 
DOS  or  just  DOS. 

What  is  DOS? 

Most  users  only  know  the  user  interface  of  DOS,  with  which  you  run  programs, 
format  disks,  etc.  In  the  following  sections,  however,  you’ll  view  DOS  from  an 
angle  you  may  not  have  known  existed. 

Beneath  the  surface  of  DOS  many  processes  takes  place.  DOS  uses  a  large  number 
of  different  routines  (called  functions)  to  accomplish  its  tasks.  These  functions  are 
available  to  the  user  as  well  as  to  DOS.  The  main  focus  is  on  how  these  functions 
can  be  used  in  practical  applications. 

This  chapter  includes  a  historical  sketch  of  the  development  of  DOS,  highlighting 
its  origins  in  the  CP/M  operating  system.  You’ll  learn  the  differences  between 
transient  and  resident  commands,  COM  and  EXE  files,  and  DOS  file  access. 

The  data  structures  which  act  as  the  connecting  link  between  the  different  DOS 
functions  will  also  be  examined  in  this  chapter.  These  data  structures  make  mass 
storage  devices  such  as  floppy  disks  and  a  hard  disk  possible. 

Finally,  this  chapter  discusses  each  DOS  function  in  detail,  and  includes  a  brief 
look  at  DOS  Version  4.0. 
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6.1  A  Short  History  of  DOS 

DOS  appeared  in  1980,  at  a  time  when  8-bit  systems  and  CP/M  80  operating 
systems  made  up  the  majority  of  microcomputers.  A  few  years  before,  Intel  had 
designed  the  8086  microprocessor,  the  first  generation  of  16-bit  microprocessors. 

In  April  1980  the  CP/M-86  operating  system  announced  by  Digital  Research  for 
use  on  the  8086  processor  was  unavailable.  A  programmer  named  Tim  Paterson 
began  developing  a  new  operating  system.  This  system  is  the  ancestor  of  the 
current  MS-DOS. 

At  this  time  a  lot  of  software  was  available  for  CP/M-80  systems.  The 
development  of  new  software  for  an  8086  operating  system  would  have  required 
enormous  expenses  and  effort.  Paterson’s  goal  was  to  allow  easy  conversion  of 
existing  software  from  CP/M-80  to  the  new  operating  system.  He  tried  to  include 
the  functions  and  the  most  important  data  structures  of  the  CP/M-80  operating 
system,  while  removing  the  weak  points  of  CP/M-80.  The  finished  product  was  an 
operating  system  that  required  only  6K  of  memory.  Programs  developed  for  CP/M- 
80  could  also  be  converted  with  little  effort  to  the  8086.  The  new  system  was 
named  86-DOS. 

Meanwhile  IBM  was  developing  a  16-bit  microcomputer.  Microsoft  offered  to 
develop  an  operating  system  for  it.  Microsoft  obtained  a  prototype  of  the  new 
computer  from  IBM,  bought  the  rights  to  Paterson’s  operating  system,  and  made 
some  enhancements  to  the  software.  Even  though  Paterson  was  participating  in  the 
project,  the  strict  security  provisions  of  IBM  prevented  him  from  seeing  the 
machine  for  which  he  had  developed  an  operating  system.  Despite  this,  the 
development  work  was  concluded  in  August  of  1981.  The  new  operating  system 
was  released  for  the  IBM  PC  under  the  name  MS-DOS. 

Many  changes  have  been  made  to  DOS  since  1981.  Because  these  changes  are  of 
great  significance  to  the  DOS  programmer,  this  chapter  contains  a  segment  for 
each  major  version  of  DOS.  Each  segment  lists  changes  from  preceding  versions 
with  explanations.  Many  components  of  DOS  are  explained  here,  which  will  give 
you  some  idea  of  the  complexity  of  an  operating  system. 


Version  1.0 

This  version  represented  a  compromise  for  Microsoft.  They  had  relied  heavily  on 
CP/M-80  and  needed  to  transfer  existing  programs  quickly  and  easily.  This  can  be 
seen  in  the  fact  that  the  file  names  (eight-character  filename,  three-character 
extension)  was  identical  with  CP/M-80.  Also,  the  designation  of  the  disk  drives 
and  the  internal  structure  had  many  similarities  to  the  successful  8-bit  operating 
system. 
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During  this  time  many  improvements  and  enhancements  of  the  hardware  occurred, 
such  as  more  RAM  and  faster  disk  drives.  Microsoft  decided  to  make  DOS  more 
hardware  independent  by  removing  the  association  between  physical  file  length  and 
logical  file  length. 

In  CP/M-80  every  disk  was  divided  into  128-byte  units  which  could  only  be 
accessed  as  a  whole.  This  is  why  you  couldn’t  access  individual  bytes  on  the  disk 
(this  created  a  programming  problem  that  shouldn’t  have  existed  in  the  first  place). 
DOS  solved  this  problem  by  making  the  logical  and  physical  data  length 
independent  of  one  another.  In  addition,  functions  were  implemented  to  permit 
reading  or  writing  of  more  than  one  data  set  of  a  file  on  a  disk.  Treating  the  input 
and  output  devices  like  files  achieved  hardware  independence.  These  input  and 
output  devices  were  assigned  their  own  names; 

CON  (Keyboard  and  Display) 

PRN  (Printer) 

AUX  (serial  Interface) 

If  you  used  one  of  these  three  names  instead  of  a  filename  to  access  a  file  with  a 
DOS  routine,  then  the  computer  addressed  the  corresponding  device  and  not  the 
disk  drive.  This  also  permitted  redirecting  input  and  output  from  the  keyboard  or 
screen  to  a  file  or  other  device. 

Before  this  time,  DOS  only  supported  program  files  which  loaded  and  executed 
from  a  fixed  location  in  memory.  This  proved  to  be  impractical,  and  so  Version 
1.0  introduced  a  new  program  file  type.  This  new  file  type  had  a  file  extension  of 
.EXE  instead  of  .COM.  An  .EXE  file  could  be  stored  and  executed  from  almost 
any  memory  location. 

Two  changes  were  made  to  the  command  processor,  the  part  of  the  operating 
system  which  accepts  commands  from  the  user  and  controls  the  execution  of  these 
commands.  The  first  change  was  to  store  the  command  processor  in  a  separate  file 
named  COMMAND  COM.  This  allowed  programmers  to  develop  a  customized 
command  processor  and  link  it  to  the  system. 

The  second  change  was  to  divide  the  command  processor  into  a  resident  and  a 
transient  portion.  This  approach  was  taken  because  early  PC  systems  contained 
only  a  small  amount  of  memory.  The  resident  portion  was  written  to  be  as  small 
as  possible.  Many  DOS  commands  were  stored  on  disk  and  loaded  and  run  only 
when  required,  hence  the  name  transient.  Examples  of  transient  commands  are 
DISKCOPY  and  FORMAT. 

A  major  innovation  that  took  MS-DOS  Version  1.0  beyond  CP/M-80  was  the 
introduction  of  the  FAT  (file  allocation  table)  on  disk.  Every  entry  in  this  table 
corresponds  to  a  data  area  of  512  bytes  (called  a  sector)  on  the  disk.  The  FAT 
indicates  whether  the  sector  is  allocated  to  a  file  or  is  still  available. 
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The  FAT  has  special  significance  in  connection  with  the  directory  entry  which 
exists  for  every  file  type.  Besides  the  filename  and  other  information,  it  also 
indicates  the  number  of  an  entry  in  the  FAT  which  corresponds  with  the  first 
sector  of  a  file  on  the  disk.  This  FAT  entry  points  to  another  FAT  entry  which 
indicates  the  next  sector  which  was  allocated  to  the  file.  The  other  FAT  entries  on 
a  disk  perform  the  same  task. 

In  conclusion  two  additional  developments  should  be  mentioned  which  make  work 
with  the  PC  easier  for  the  user: 

The  introduction  of  batch  processing  offers  the  user  the  option  of  placing  several 
DOS  commands  into  one  file.  When  you  “run”  this  file  (which  has  a  file  extension 
of  .BAT),  DOS  executes  the  individual  commands  from  this  file  as  if  you  had 
entered  the  commands  from  the  keyboard,  thus  saving  the  user  time  in  entering 
frequently  used  groups  of  commands  repeatedly. 

The  current  date  and  time  follows  every  filename.  DOS  includes  this  data  to  help 
the  user  determine  the  last  time  a  file  was  modified. 

When  IBM  introduced  a  new  PC  in  1982  which  used  both  sides  of  a  disk  for  data 
storage,  Microsoft  released  DOS  Version  1.1. 


Version  2.0 

IBM  announced  a  new  personal  computer  in  March  of  1983,  called  the  PC  XT, 
which  in  addition  to  the  floppy  disk  drive  also  had  a  hard  disk  (also  called  a  fixed 
disk).  The  enormous  capacity  of  this  hard  disk  (10  megabytes)  allowed  the  user  to 
store  several  hundred  files  on  one  unit,  but  created  some  problems  for  the  qierating 
system.  The  largest  problem  was  that  DOS  could  only  handle  one  directory  for 
each  storage  unit.  It  would  be  nearly  impossible  for  the  hard  disk  user  to  maintain 
hundreds  of  files  in  a  single  directory.  Microsoft  had  two  options  to  solve  this 
problem:  They  could  either  borrow  an  idea  from  the  CP/M-80  operating  system,  or 
from  the  UNIX  operating  system. 

CP/M  views  a  hard  disk  as  several  individual  disk  drives  which  share  the  total 
storage  on  the  hard  disk,  each  with  only  one  directory. 

UNIX  uses  a  hierarchical  file  system,  in  which  every  storage  unit  has  a  root 
directory  which  can  contain  subdirectories  as  well  as  files.  Every  one  of  these 
subdirectories  can  have  subdirectories  within  them.  This  creates  a  directory  tree 
whose  trunk  is  the  root  directory  and  whose  branches  are  represented  by  the 
individual  subdirectories. 

Microsoft  chose  the  hierarchical  file  system,  which  has  since  become  a  popular 
component  of  DOS.  This  was  another  step  away  from  CP/M-80  toward  an 
efficient  16-bit  operating  system.  With  the  introduction  of  an  hierarchical  file 
system  some  major  changes  had  to  be  made  in  the  area  of  file  control  by  DOS. 
Before  this  time,  file  access  was  conducted  through  a  file  control  block  or  FCB. 
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This  file  control  block  had  been  introduced  for  compatibility  with  CP/M-80.  The 
FCB  contained  important  information  about  the  name,  size  and  location  of  a  file 
on  disk.  This  CP/M  would  not  allow  access  to  a  file  in  another  directory. 

The  DOS  developers  standardized  file  access  through  DOS  functions.  The  access  to 
a  file  occurs  exclusively  through  the  file  handles.  A  handle  is  a  numerical  value 
passed  to  the  program  as  soon  as  it  opens  a  file  through  a  DOS  function.  The 
FCBs  were  not  eliminated,  but  the  programmer  no  longer  came  in  contact  with 
them  since  DOS  took  over  the  control  block  manipulation. 

An  important  innovation  was  the  introduction  of  installable  device  drivers.  They 
offer  the  programmer  the  capability  of  easily  including  different  devices  in  DOS, 
such  as  an  exotic  hard  disk,  a  mouse  or  a  tape  drive.  Version  2.0  introduced  the 
display  device  driver  ANSI.SYS  which  gave  the  programmer  flexibility  in  cursor 
positioning  and  color  selection  through  DOS  functions. 

Version  2.0  added  the  option  of  formatting  the  individual  tracks  of  a  disk  with  nine 
sectors  instead  of  eight.  This  increased  the  storage  capacity  of  a  single-sided  disk 
from  160K  to  180K,  and  the  capacity  of  a  double-sided  disk  from  320K  to  360K. 


Version  3.0 

Version  3.0,  like  Version  2.0,  was  developed  for  a  new  PC,  the  IBM  PC  AT.  It 
was  released  in  August  of  1984  and  supported  the  20  megabyte  hard  disk  of  the 
ATs  as  well  as  the  high  capacity  1.2  megabyte  floppy  disk  drive.  Many  changes 
occurred  in  DOS’s  internal  routines.  They  contributed  to  faster  execution  of  certain 
operations,  but  are  transparent  to  the  programmer. 

Version  4.0 

DOS  4.0  appeared  on  the  market  in  August  1988.  Before  this,  Microsoft  released  a 
new  multiprocessing  operating  system  called  OS/2.  Before  OS/2,  multiprocessing 
was  unknown  to  MS-DOS. 

The  user  can  easily  see  the  changes  to  DOS  4.0  over  earlier  versions  of  DOS.  In 
place  of  the  line-oriented  command  line  interpreter  used  by  DOS  versions  3.3  and 
earlier,  DOS  4.0  has  a  Shell  allowing  user-defined  menus,  easy  selection  of 
applications,  files  and  directories  from  both  mouse  and  keyboard. 

Most  important  are  the  unseen  changes  made  to  DOS,  particularly  in  adapting  the 
operating  system  to  the  new  hardware  standards  on  the  market  As  the  operating 
system  has  grown  in  power,  it  has  also  grown  in  complexity  and  memory  use.  For 
example,  earlier  versions  of  DOS  were  limited  to  "only”  640K  of  RAM  and  a  32 
megabyte  hard  disk.  However,  DOS  4.0  handles  the  Expanded  Memory  System 
(EMS)  following  the  LIM  standard,  normal  RAM  capacity  of  up  to  8  megabytes, 
and  hard  disks  up  to  2  gigabytes  (2048  megabytes)  capacity. 
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6.2  Internal  Structure  of  DOS 

Several  major  components  comprise  DOS,  each  with  a  certain  task  within  the 
system.  The  three  most  important  components  are  the  DOS-BIOS,  the  DOS  kernel 
and  the  command  processor.  Each  appear  in  a  separate  file. 

DOS-BIOS 

DOS-BIOS  is  stored  in  a  system  file  which  appears  under  various  names 
(IBMBIO.COM,  IBMIO.SYS  or  lO.SYS).  This  file  has  the  file  attributes  Hidden 
and  Sys,  which  means  this  system  file  doesn’t  appear  when  the  DIR  command  is 
entered.  The  DOS-BIOS  contains  the  device  drivers  for  the  following  units: 

CON  (Keyboard  and  Display) 

PRN  (Printer) 

AUX  (Serial  Interface) 

CLOCK  (Clock) 

Disk  drives  and/or  hard  disks  which  have  the  unit 
designations  A,  B  and  C 

If  DOS  wants  to  communicate  with  one  of  these,  it  accesses  a  device  driver 
contained  in  this  module,  which  in  turn  uses  the  routines  of  ROM-BIOS.  The 
DOS-BIOS  (i.e.,  the  connection  between  individual  device  drivers  and  other 
hardware  dependent  routines)  are  the  most  hardware  dependent  components  of  the 
operating  system,  and  vary  from  one  computer  to  another. 

Do  not  confuse  the  device  drivers  in  this  module  with  the  installable  device  drivers. 
The  DOS-BIOS  device  drivers  cannot  be  changed  by  the  user. 

DOS  kernel 

The  DOS  kernel  in  the  IBMDOS.COM  or  MSDOS.SYS  file  is  normally  invisible 
to  the  user.  It  contains  file  access  routine  handles,  character  input  and  output,  and 
more.  The  routines  operate  independent  of  the  hardware  and  use  the  device  drivers 
of  DOS-BIOS  for  keyboard,  screen  and  disk  access.  The  module  can  be  used  by 
different  PCs  without  being  limited  to  one  machine.  User  programs  can  access 
these  functions  in  the  same  manner  as  the  ROM-BIOS  functions:  every  function 
can  be  called  with  a  software  interrupt.  The  processor  registers  pass  the  function 
number  and  the  parameters. 

Command  processor 

Unlike  the  two  modules  described  above,  the  command  processor  is  contained  in 
the  file  named  COMMAND.COM.  It  displays  the  “A>”  or  “C>”  prompt  on  the 
screen,  accepts  user  input  and  controls  input  execution.  Many  users  wrongly  think 
that  the  command  processor  is  actually  the  operating  system.  In  reality  it  is  only  a 
special  program  which  executes  under  DOS  control. 
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The  command  processor,  also  called  a  shell  in  programme's  teminology,  actually 
consists  of  three  modules:  A  resident  portion,  a  transient  portion  and  the 
initialization  routine. 

The  resident  portion  (the  part  that  always  stays  in  the  computer’s  memory) 
contains  various  routines  called  critical  error  handlers.  These  allow  the  computer  to 
react  to  different  events,  such  as  pressing  the  <CtrlxC>  or  <CtrlxBreak>  keys 
or  errors  during  communication  with  external  devices  (e.g.,  disk  drives  and 
printers).  The  latter  cause  the  message: 

Abort,  Retry,  Ignore 
or 

Abort,  Retry,  Fail 

The  transient  portion  contains  code  for  displaying  the  (A>)  prompt,  reading  user 
input  from  the  keyboard  and  executing  the  input.  The  name  of  this  module  is 
derived  from  the  fact  that  the  RAM  memory  where  it  is  located  is  unprotected,  and 
can  be  overwritten  under  certain  circumstances.  When  a  program  ends,  control 
returns  to  the  resident  portion  of  the  command  processor.  It  executes  a  checksum 
program  to  determine  whether  the  transient  portion  was  overwritten  by  the  applica¬ 
tion  program.  If  so,  the  resident  portion  reloads  the  transient  portion. 

The  initialization  portion  loads  during  the  booting  process  and  initializes  DOS. 
This  part  of  the  command  processor  will  be  examined  in  detail  in  the  next  chapter. 
When  its  job  ends,  it  is  no  longer  needed  and  the  RAM  memory  it  occupies  can  be 
overwritten  by  another  program.  The  commands  accepted  by  the  transient  portion 
of  the  command  processor  can  be  divided  into  three  groups:  internal  commands, 
external  commands  and  batch  files. 

Internal  commands  lie  in  the  resident  portion  of  the  command  processor.  COPY, 
RENAME  and  DIR  are  internal  commands. 

External  commands  must  be  loaded  into  memory  from  diskette  or  hard  disk  as 
needed.  FORMAT  and  CHKDSK  are  external  commands. 

After  execution  the  command  processor  releases  the  memory  used  by  these 
programs.  This  memory  can  then  be  used  for  other  purposes. 

Batch  files 

A  batch  nie  is  a  text  file  containing  a  series  of  DOS  commands.  When  a  batch  file 
is  started,  a  special  interpreter  in  the  transient  portion  of  the  command  processor 
executes  the  batch  file  commands.  Execution  of  batch  file  commands  is  the  same 
as  if  the  user  entered  them  from  the  keyboard.  An  important  batch  file  is  the 
AUTOEXEC.B  AT  file  which  executes  immediately  after  DOS  is  first  loaded. 

Like  all  commands  of  a  batch  file,  these  commands  are  checked  for  internal 
commands,  external  commands  or  calls  to  other  batch  files.  If  the  first  is  true,  the 
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command  executes  immediately,  since  the  code  is  already  in  memory  (in  the 
transient  part  of  the  command  processor).  If  it  is  an  external  command  or  another 
batch  file,  the  system  searches  the  current  directory  for  the  command.  If  such  a  file 
doesn’t  exist  in  this  directory,  all  directories  specified  in  the  PATH  command  are 
searched  in  sequence.  During  the  search,  only  files  with  the  .COM,  .EXE  or  .BAT 
extensions  are  examined. 

Since  the  command  processor  cannot  search  for  all  three  extensions  at  the  same 
time,  it  first  searches  for  files  with  .COM  extensions,  then  for  £XE  files  and 
finally  for  .BAT  files.  If  the  search  is  unsuccessful,  the  screen  displays  an  error 
message  and  the  system  waits  for  new  input. 
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6.3  Booting  DOS 

When  a  PC  is  turned  on,  the  program  contained  in  ROM  begins  executing.  This 
ROM  program  is  sometimes  called  the  ROM-BIOS,  POST  (power-on  self  test), 
resident  diagnostics  or  bootstrap  ROM.  It  performs  several  tests  on  the  hardware 
and  memory  and  then  starts  to  load  the  DOS. 

First  the  PC  checks  for  a  disk  in  the  floppy  disk  drive.  If  a  disk  exists  in  the 
floppy  disk  drive,  the  PC  checks  the  disk  for  the  boot  sector.  If  a  disk  is  not  in  the 
drive,  the  PC  searches  for  a  hard  disk  from  which  to  boot  DOS.  If  no  hard  disk 
exists,  the  PC  displays  an  error  message  asking  the  user  to  insert  a  system  disk. 

The  first  sector  on  a  bootable  floppy  disk  or  hard  disk  is  called  the  boot  sector.  The 
program  in  the  boot  sector  is  re^  into  memory  and  executes.  First  it  checks  for 
the  presence  of  two  files:  IBMBIO.COM  (sometimes  called  lO.SYS)  and 
IBMDOS.COM  (sometimes  called  MSDOS.SYS).  A  bootable  floppy  disk  or  hard 
disk  must  contain  these  two  files  or  an  error  message  is  displayed.  Next  these 
program  files  are  loaded  into  memory. 

The  program  file  IBMBIO.COM  consists  of  two  modules.  The  first  contains  the 
basic  device  drivers — ^keyboard,  display  and  disk.  The  second  contains  the 
initialization  sequence  for  DOS.  When  the  IBMBIO.COM  program  executes  it 
continues  to  initialize  the  system  by  moving  the  DOS  kemal  (loaded  in  the 
IBMDOS.COM  program  file)  to  the  last  available  memory  location. 

The  DOS  kernal  builds  several  important  tables  and  data  areas,  and  performs 
initialization  procedures  for  individual  device  drivers  which  were  loaded  with  the 
IBMBIO.COM  program  file. 

Next,  DOS  searches  the  boot  disk  for  a  file  named  CONFIG.SYS.  If  found,  the 
commands  contained  in  the  file  are  executed.  These  commands  add  device  drivers  to 
DOS,  allocate  disk  buffers  and  file  control  blocks  for  DOS  and  initialize  the 
standard  input  and  output  devices. 

Lastly  the  command  processor  COMMAND.COM  (or  other  shell  specified  in  the 
CONFIG.SYS  file)  is  loaded  and  control  is  passed  to  it.  The  booting  process  ends 
and  the  initialization  routines  remain  as  “garbage”  data  in  memory  until 
overwritten  by  another  program. 


59 


6.  The  Disk  Operating  System 


PC  System  Programming 


6.4  COM  and  EXE  ProgtBms 

DOS  recognizes  three  types  of  “program”  files:  those  with  file  extensions  of  BAT, 
COM  and  EXE. 

This  section  describes  the  structure  and  functions  of  these  last  two  program  types. 

One  difference  between  COM  and  EXE  program  files  is  in  the  size  limitation  for 
each  type  of  program.  A  COM  program  cannot  exceed  64K  in  size.  An  EXE 
program  can  be  as  large  as  the  memory  C2^)acity  available  to  DOS. 

In  a  COM  program,  the  program  code,  data  and  stack  are  stored  in  one  64K 
partition.  All  of  the  segment  registers  are  set  at  the  start  of  the  program  and  remain 
fixed  for  the  duration  of  the  program  execution.  They  point  to  the  start  of  the  64K 
memory  segment.  The  contents  of  the  ES  register  may  be  changed  however,  since 
it  has  no  direct  effect  on  program  execution. 

In  an  EXE  program,  the  code,  data  and  stack  may  be  stored  in  different  segments, 
and  depending  on  jn-ogram  size,  may  be  distributed  over  several  segments. 

While  a  COM  program  file  is  stored  on  disk  as  an  image  copy  of  RAM  memory, 
an  EXE  program  file  is  stored  in  a  special  format  that  will  be  described  shortly. 

EXEC 


Both  program  types  can  be  loaded  and  started  using  the  DOS  EXEC  function.  Any 
user  can  access  this,  but  the  command  processor  uses  it  for  executing  external 
commands.  Before  the  EXEC  function  loads  the  program  into  memory,  it  reserves 
the  RAM  memory  to  hold  the  program.  At  the  beginning  of  this  memory  the 
EXEC  function  stores  a  PSP  {program  segment  prefix)  data  structure.  The  program 
is  then  loaded  immediately  following  the  PSP.  The  segment  registers  and  the  stack 
are  initialized  and  the  program  is  given  control.  Later,  when  the  program  ends,  the 
memory  is  released  based  on  the  contents  of  the  PSP. 
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+  OOH 

Interrupt  2 OH  call  (2  bytes) 

+  02H 

Segment  address  of  memory  (1  word) 
allocated  for  a  program 

+  04H 

Reserved  (1  byte) 

+  OSH 

Interrupt  21H  call  (5  bytes) 

+  OAH 

Copy  of  interrupt  (2  words) 

vector  22H 

+  OEH 

Copy  of  interrupt  (2  words) 

vector  23H 

+  12H 

Copy  of  interrupt  (2  words) 

vector  24H 

+  16H 

reserved  (22  bytes) 

+  2CH 

Segment  address  of  (1  word) 

environment  block 

+  2EH 

reserved  (46  bytes) 

+  5CH 

FCB  1  (16  bytes) 

+  6CH 

FCB  2  (16  bytes) 

+  80H 

Number  of  characters  (1  byte) 

in  command  line 

+  81H 

Command  line  (ended  by  CR) (127  bytes) 

Structure  of  the  PSP 

The  PSP  itself  is  always  256  bytes  long  and  contains  information  important  for 
DOS  and  the  program  to  be  executed. 

Memory  location  OOH  of  the  PSP  contains  a  DOS  function  call  to  terminate  a 
program.  This  function  releases  program  memory  and  returns  control  to  the 
command  processor  or  the  calling  program.  Memory  location  OSH  of  the  PSP 
contains  a  DOS  function  call  to  interrupt  21H.  Neither  of  these  are  used  by  DOS, 
but  are  leftovers  from  the  CP/M  system. 

Memory  location  02H  of  the  PSP  contains  the  segment  address  to  the  end  of  the 
program.  Memory  location  OAH  contains  the  previous  contents  of  the  program 
termination  interrupt  vector.  Memory  location  OEH  contains  the  previous  contents 
of  the  <Ctrl><C>  or  <Ctrl><Break>  interrupt  vector.  Memory  location  12H 
contains  the  previous  contents  of  the  critical  error  interrupt  vector.  For  each  of 
these  memory  locations,  the  program  changes  one  of  the  corresponding  vectors 
during  execution;  DOS  can  use  the  original  vector  in  the  event  that  it  detects  an 
error. 

Location  2CH  contains  the  segment  address  of  the  environment  block.  The 
environment  block  contains  information  such  as  the  current  search  path  and  the 
directory  in  which  the  COMMAND.COM  command  processor  is  located  on  disk. 
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Memory  locations  5CH  through  6CH  contain  a  file  control  block.  This  FCB  is 
not  often  used  by  DOS  since  it  does  not  support  hierarchical  files  (paths)  and  is 
also  left  over  from  CP/M. 

The  string  of  parameters  that  are  entered  on  the  command  line  following  the 
program  name  is  called  the  command  tail.  The  command  tail  is  copied  to  the 
parameter  buffer  in  the  PSP  beginning  at  memory  location  81H  and  its  length  is 
stored  at  memory  location  80H.  Any  redirection  parameters  are  eliminated  from  the 
command  tail  as  it  is  copied  to  the  parameter  buffer.  The  program  can  examine  the 
parameters  in  the  parameter  buffer  to  direct  its  execution. 

The  parameter  buffer  is  also  used  by  DOS  as  a  disk  transfer  area  (DTA)  for 
transmitting  data  between  the  disk  drive  and  memory.  Most  DOS  programs  do  not 
use  the  DTA  contained  in  the  PSP  because  it  is  another  leftover  from  CP/M. 


SSiOOOO 

DS:QQQQ  ^ _  ESiOOOO  ^ 


ESiOOOO 

CSrOOOO 

PSP  (256  BYTES) 

DS:0000 

PSP  (256  BYTES) 

IF  — 

Code ,  data 
and  stack  in 
one  64K  segment 

CS:IP— ► 

Code 

(Address  defined 
by  the  END 
command  in  an 
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program) 

SS : SP  " 

CQ .  TTTrTrTr 
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oo  •  r  r  r  r 

OJ.  doUd  aliCL  dOCL6 

JJo  .  U UU 

CS:FFFF_ 

Data 

DSiFFFF 

o  c  •  n  n  n 

ESiFFFF 

oo  .  U UU 

SS:SP-^ 

Stack 

A  comparison  of  COM  and  EXE  programs  in  memory 


6.4.1  COM  Programs 

COM  program  files  are  stored  on  disk  as  an  image  copy  of  memory.  Because  of 
this,  no  further  processing  is  required  during  loading.  Therefore  COM  programs 
load  faster  and  start  execution  faster  than  EXE  programs. 

A  COM  program  loads  immediately  following  the  PSP.  Execution  then  begins  at 
the  first  memory  location  following  the  PSP  at  offset  lOOH.  For  this  reason,  a 
COM  program  must  begin  with  an  executable  instruction,  even  it  if  is  only  a 
jump  instruction  to  the  actual  start  of  the  program. 
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COM  program  memory  limits 

As  described  in  the  previous  section,  a  COM  program  is  limited  to  64K  (65,536 
bytes)  in  length.  The  PSP  (256  bytes)  and  at  least  1  word  (2  bytes)  for  the  stack 
must  be  reserved  from  this  total.  Even  though  the  length  of  the  COM  program  can 
never  exceed  64K,  DOS  reserves  the  entire  available  RAM  for  a  program. 
Therefore  DOS  can  allocate  no  further  memory,  and  the  COM  program  cannot  call 
another  program  using  the  EXEC  function.  This  limitation  can  be  overcome  by 
releasing  the  unused  memory  for  other  uses  with  a  DOS  function. 

When  control  is  turned  over  to  the  COM  program,  all  segment  registers  point  to 
the  beginning  of  the  PSP.  Because  of  this,  the  beginning  of  the  COM  program 
(relative  to  the  beginning  of  the  PSP)  is  always  at  address  lOOH.  The  stack  pointer 
points  to  the  end  of  the  64K  memory  segment  containing  the  COM  program 
(usually  FFFEH).  During  every  subroutine  call  within  the  COM  program,  the 
stack  is  adjusted  by  2  bytes  in  the  direction  towards  the  end  of  the  program.  The 
programmer  is  responsible  for  preventing  the  stack  from  growing  and  overwriting 
the  program,  which  would  cause  it  to  crash. 

There  are  several  ways  to  end  a  COM  program  and  return  control  to  DOS  or  the 
calling  program: 

If  the  program  runs  under  DOS  Version  1.0,  it  can  be  terminated  by  calling 
interrupt  21H  function  0,  or  by  calling  interrupt  20H.  It  can  also  be  terminated  by 
using  the  RET  (RETum)  assembler  instruction.  When  this  instruction  executes, 
the  program  continues  at  the  address  which  is  at  the  top  of  the  stack.  Since  the 
EXEC  function  stored  the  value  0  at  this  location  before  turning  control  over  to 
the  COM  program,  program  execution  continues  at  location  CS:0  (the  start  of  the 
PSP).  Recall  that  this  location  contains  the  call  for  interrupt  20H  which 
terminates  the  program. 

Programs  that  run  on  versions  later  than  DOS  Version  1.0,  are  terminated  using 
interrupt  21H  function  4CH.  The  terminating  program  can  pass  a  numeric  return 
code  to  the  calling  program.  For  example,  a  value  of  0  may  indicate  that  the 
program  executed  successfully,  while  a  non-zero  value  indicates  an  error  during 
execution. 

Next  weTl  talk  about  a  few  of  the  details  that  the  assembly  language  programmer 
will  have  to  take  care  of  in  developing  a  COM  program.  Note  that  the  high  level 
language  programmer  is  usually  insulated  from  these  details  by  the  compiler  or 
interpreter,  so  you  may  want  to  skip  ahead. 

A  COM  program  is  limited  to  a  64K  size.  The  code  and  data  for  the  program  must 
be  contained  within  a  single  segment  and  addressed  through  NEAR  procedures. 
Therefore  an  assembly  language  program  that  is  to  become  a  COM  program  may 
not  contain  any  FAR  procedures. 
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Before  calling  a  COM  program,  DOS  reserves  all  available  memory  for  the 
program  even  though  it  normally  uses  only  one  64K  segment  and  indicates  this  by 
setting  memory  location  2  in  the  PSP.  Usually  the  program  terminates  and  the 
memory  is  made  available  to  DOS  again. 

In  some  circumstances  you  may  want  to  write  a  program  which  is  to  remain 
resident  after  execution.  But  DOS  thinks  that  there  isn’t  any  memory  available. 
This  prevents  other  programs  from  loading  and  executing. 

In  other  circumstances  you  may  want  to  execute  another  program  from  this  COM 
program  using  the  EXEC  function.  Again,  since  DOS  thinks  that  memory  is 
unavailable,  it  won’t  allow  the  new  program  to  run. 

Both  of  these  problems  can  be  circumvented  by  freeing  up  the  unused  memory. 

There  are  two  approaches  in  doing  this:  release  only  the  memory  outside  of  the 
64K  COM  segment  or  release  memory  outside  of  the  64K  COM  segment  plus  any 
unused  memory  within  the  64K  COM  segment.  This  creates  more  memory  for 
other  programs,  but  relocates  the  stack  outside  the  protected  COM  segment 
memory,  leaving  it  open  to  be  overwritten  by  other  programs.  Because  of  this,  the 
stack  must  be  relocated  to  the  end  of  the  code  segment  before  releasing  the 
memory.  The  stack  must  have  a  certain  limit  in  size  (in  most  cases  512  bytes  will 
be  more  than  enough). 

The  following  sample  program  can  serve  as  an  example  for  developing  a  COM 
program.  A  small  (init)  routine  relocates  the  stack  to  the  end  of  the  code  segment 
after  the  start  of  the  program  and  releases  all  remaining  memory.  Even  when  this 
program  loads  another  program,  it  remains  resident.  This  routine  can  be  useful  to 
applications,  and  can  be  part  of  any  COM  program. 

; test com. asm 

code  segment  para  'CODE'  ;Definition  of  CODE-segments 

org  10 Oh  ; starts  at  Address  lOOH 

/directly  behind  the  PSP 

assume  csicode,  dsicode,  esrcode,  ssicode 

;all  segments  point  to  the  CODE 
; segment 

start:  jmp  init  /Call  of  the  Initialization  Routine 


/ —  Data,  Buffers  and  - 

/ —  Variables  can  be  stored  here 


/ *=  Program  =*======================================================== 

prog  proc  near  /this  Procedure  is  the  actual 

/Main  program  and  is  executed  after 
/the  Initialization 


mov  ax,4C00h  /Terminate  Program  through  calling  a 
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int  21h  ;DOS  function  on  error  code  0 


prog  endp  ;End  of  the  PROG  procedure 

; —  Initialization  - 


init : 

mov 

ah,  4Ah 

;Change  Function  number  for  memory  size 

mov 

bx, offset 

endp 

;Calculate  number  of  paragraphs  (16  byte 

mov 

cl,  4 

;each)  available  to  the  program 

shr 

bx,  cl 

inc 

bx 

int 

21h 

;Call  function  through  DOS-Interrupt 

mov 

sp, offset 

endp 

;Set  new  stack-Pointer 

jmp 

prog 

init  end 

label 

near 

;==  stack 


dw  (256- ( (init_end-init)  shr  1))  dup  (?) 

;the  stack  has  256  Words,  but  includes 
;the  code  of  the  INIT-Routine  which 
;after  its  execution  is  no  longer  needed 

endp  equ  this  byte  ;End  of  memory  used  by  this 

; program 


;==  End  ==«=========. 

code  ends 

end  start 


;End  of  the  CODE-segment 

;End  of  the  Assembler-Program.  For 

; execution  use  START  command 


First  you  must  assemble  the  source  program  using  the  assembler.  In  the  following 
example,  we  are  using  the  Microsoft  assembler.  Following  assembly,  you  then 
link  the  object  code  using  the  LINK  program.  When  you  execute  the  LINK 
program,  the  following  message  appears: 

Warning:  no  stack  segment 

You  can  disregard  this  message.  If  the  program  contains  no  errors,  the  LINK 
program  creates  an  EXE  file.  Since  you  want  a  COM  program  and  not  an  EXE 
program  developed,  you  must  run  the  EXE2BIN  program  as  the  last  step.  This 
converts  EXE  programs  into  COM  programs.  Here  are  the  steps  for  preparing  an 
assembly  language  program  using  the  Microsoft  assembler.  The  program  to 
assemble  is  named  TESTCOM.ASM. 

masm  test com; 
link  test com; 

exe2bin  testcom.exe  testcom.com 

If  all  steps  were  carried  out  correctly,  the  program  TESTCOM.COM  can  be 
executed  from  DOS  by  simply  typing  TESTCOM. 
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6.4.2  EXE  Programs 

EXE  programs  have  an  advantage  over  COM  programs  because  they  are  not 
limited  to  a  maximum  length  of  64K  for  code,  data  and  stack.  The  disadvantage  of 
this  is  the  greater  complexity  of  these  files.  This  means  that  in  addition  to  the 
program  itself,  other  information  must  be  stored  in  an  EXE  file. 

EXE  vs.  COM 

EXE  programs  contain  separate  segments  for  code,  data  and  stack  which  can  be 
organized  in  any  sequence.  Unlike  a  COM  program,  an  EXE  program  loads  into 
memory  from  disk  and  undergoes  processing  by  the  EXEC  function  and  then 
finally  begins  execution.  This  is  necessary  because  of  the  limitations  already 
described  for  COM  programs. 

EXE  programs  aren’t  limited  to  loading  at  a  fixed  memory  location,  but  to  any 
desired  location  in  memory  that’s  a  multiple  of  16.  Since  an  EXE  program  can 
have  several  segments,  this  requires  the  use  of  FAR  machine  language 
instructions.  For  example,  a  main  program  can  be  in  one  segment  and  call  a 
subroutine  in  another  segment.  The  segment  address  must  be  provided  for  this 
FAR  instruction  in  addition  to  the  offset  for  the  routine  to  be  called.  The  problem 
is  that  the  segment  address  may  be  different  for  every  execution  of  the  program. 

COM  files  avoid  this  problem  since  the  program  size  is  limited  to  64K,  which 
makes  the  use  of  FAR  commands  unnecessary.  EXE  programs  solve  this  problem 
in  a  more  complex  way:  the  LINK  i»*ogram  places  a  data  structure  at  the  beginning 
of  every  EXE  file  which  contains  the  addresses  of  all  segments,  among  other 
things.  It  contains  the  addresses  of  all  memory  locations  in  which  the  segment 
address  of  a  certain  segment  is  stored  during  program  execution. 

If  the  EXEC  function  loads  the  EXE  program,  it  knows  the  addresses  where  the 
various  segments  should  be  loaded.  It  can  therefore  enter  these  values  into  the 
memory  locations  at  the  beginning  of  the  EXE  file.  Because  of  this,  more  time 
elapses  between  the  initial  program  call  and  when  the  program  actually  begins 
execution  than  for  a  COM  program.  The  EXE  program  also  occupies  more 
memory  than  a  COM  program.  The  following  illustration  shows  the  structure  of 
the  header  fcM*  an  EXE  file. 
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1  EXE  file  header  structure  1 

Address 

Contents 

Type 

+00H 

EXE  program  identifier  (5A4Dh) 

1  WORD 

+02H 

file  length  MOD  512 

1  WORD 

+04H 

file  length  DIV  512 

1  WORD 

+06H 

Number  of  segment  addresses  for  passing 

1  WORD 

+08H 

Head  size  in  paragraphs 

1  WORD 

+0AH 

Minimum  no.  of  extra  paragraphs  needed 

1  WORD 

+0EH 

Maximum  no.  of  extra  paragraphs  needed 

1  WORD 

■+njH 

SP  register  contents  on  program  start 

1  WORD 

+12H 

Checksum  based  on  EXE  file  header 

1  WORD 

+14H 

IP  register  contents  on  program  start 

1  WORD 

+16H 

Start  of  code  segment  in  EXE  file 

1  WORD 

+18H 

Relocation  table  address  in  EXE  file 

1  WORD 

+1AH 

Overlay  number 

1  WORD 

+1CH 

Buffer  memory 

1  WORD 

+??H 

Address  of  passing  segment  addresses 
(relocation  table) 

1  WORD 

+??H 

Program  code,  data  and  stack  segment 

1  WORD 

EXE  file  header  construction 

After  the  segment  references  within  the  EXE  program  have  been  resolved  to  the 
current  addresses,  the  EXEC  function  sets  the  DS  and  the  ES  segment  register  to 
the  beginning  of  the  PSP  which  also  precedes  all  EXE  programs  in  memory. 
Because  of  this,  the  EXE  program  can  access  the  information  contained  in  the 
PSP,  such  as  the  address  of  the  environment  block  and  the  parameters  contained  in 
the  command  line  (command  tail).  The  stack  address  and  the  contents  of  the  stack 
pointer  are  stored  in  the  EXE  file  header  and  accessed  from  there.  This  also  applies 
to  the  code  segment  address  containing  the  first  instructions  of  the  program,  and 
the  program  counter.  After  the  values  have  been  assigned,  the  program  execution 
starts. 

To  ensure  compatibility  with  future  DOS  versions,  an  EXE  program  should 
terminate  by  calling  interrupt  21H  function  4CH. 

Of  course,  memory  must  be  available  for  the  EXE  program.  The  EXE  loader 
determines  the  total  program  size  based  on  the  size  of  the  individual  segments  of 
the  EXE  program.  Then  it  can  allocate  this  amount  of  memory  and  some 
additional  memory  immediately  following  the  EXE  program.  The  first  two  fields 
of  the  EXE  program  file  header  contain  the  minimum  and  maximum  size  of 
memory  required  in  paragraphs  (1-6  bytes). 

First,  the  EXE  loader  tries  to  reserve  the  maximum  number  of  paragraphs.  If  this 
is  not  possible  the  loader  tries  to  reserve  the  remaining  memory  which  may  be  no 
smaller  than  the  minimum  number  of  paragraphs.  These  fields  are  determined  by 
the  compiler  or  assembler,  nfli  the  lii^er.  The  minimum  is  0  and  the  maximum 
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allowed  is  FFFFH.  This  last  number  is  unrealistic  in  most  cases  (it  adds  up  to  1 
megabyte)  but  reserves  the  entire  memory  for  the  EXE  program. 

This  brings  us  back  to  the  same  problem  as  in  COM  programs.  EXE  files  make 
poor  resident  programs,  but  an  EXE  program  may  ne^  to  call  another  program 
during  execution.  This  is  possible  only  by  first  releasing  the  additional  reserved 
memory.  The  following  program  below  contains  a  routine  which  reduces  the 
reserved  memory  to  a  minimum. 

The  program  uses  separate  code,  data  and  stack  segments.  It  can  serve  as  a  model 
for  other  EXE  programs  that  you  can  write. 

;  test exe. asm 


;==  stack 

stack 

segment  para  stack 

/Definition  of  the  stack-segment 

dw  256  dup  (?) 

;the  stack  has  256  Words 

stack 

ends 

;End  of  the  stack-segment 

data 

segment  para  ' DATA 

'  /Definition  of  the  Data-segment 

;all  data,  buffers 

and  variables  can  be  stored  here 

data 

ends 

/End  of  the  Data  segment 

code 

segment  para  ' CODE ' 

'  /Definition  of  the  CODE-segment 

assume  csrcode,  ds; 

:data,  ss: stack 

/CS  defines  the  Code,  DS 
/the  Data  and  SS  the  stack 
/ segment 

prog 

proc  far 

/this  procedure  is  the  actual 
/Main  program  and  is  executed  after 
/the  program  start 

mov  ax, data 
mov  ds, ax 
call  set free 

/Load  segment  address  of  the  Data  segment  into 

/the  DS-Register 

/release  memory  not  needed 

; store  application 

program  here  - 

mov  ax,4C00h 
int  21h 

/terminate  with  call  of  DOS  function 
/on  return  of  error  code  0 
/terminate 

prog 

endp 

/End  of  PROG  Procedure 

—  SETFREE  :  release  memory  storage  not  occupied  - 

—  Inputt  :  ES  =  Address  of  PSP 

—  Output  :  none 

—  Register  :  AX,  BX,  CL  and  FLAGS  are  changed 

—  Info  :  Since  the  stack-segment  is  always  the  last  segment  in  an 

EXE  file,  ESiOOOO  points  to  the  beginning  and  SS:SP 
to  the  end  of  the  program  in  storage.  Because  of  this  the 
length  of  the  program  can  be  calculated. 
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set free 


setfree 
;==  End 


code 


proc  near 


mov 

bx,ss 

; subtract  the  two  segment  addresses 

inov 

ax,es 

;froro  each  other.  The  result  is  the 

sub 

bx,ax 

; number  of  paragraphs  from  PSP  to 
;the  beginning  of  the  stack 

mov 

ax,sp 

; since  the  stackpointer  is  a  the  end 

mov 

cl, 4 

;of  the  stack  segment,  its  content 

shr 

ax,  cl 

; gives  the  length  of  the  stacks 

add 

bx,  ax 

;add  to  the  present  length 

inc 

bx 

;one  more  paragraph  as  a  precaution 

mov 

ah, 4 ah 

;pass  new  size  to  DOS 

int 

21h 

ret 

;back  to  calling  program 

endp 

ends 

;End  of  the  CODE-segment 

end 

prog 

;End  of  the  Assembler  program. 

; Start  execution  with  the  PROG  procedure 


To  develop  an  EXE  program,  it  must  be  assembled  like  a  normal  program  with  an 
assembler.  Then  it  is  linked  with  the  LINK  program.  If  the  program  contains  no 
errors,  the  LINK  p-ogram  creates  an  EXE  file. 

Here  are  the  individual  steps  for  preparing  an  EXE  program  from  the  assembly 
language  source  named  TESTEXE.ASM. 

masm  testexe; 
link  testexe; 


If  all  these  steps  were  executed  correctly,  the  program  TESTEXE.EXE  can  be 
started  from  the  DOS  level  by  typing  TESTEXE. 
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6.5  Character  Input  and  Output  from  DOS 

When  first  learning  a  programming  language,  many  beginners  learn  the  basic  input 
and  output  instructions  of  the  language.  In  much  the  same  way,  programmers  get 
their  experience  writing  DOS  accessible  programming  by  using  the  functions  for 
character  input  and  output.  For  this  reason,  this  book  starts  with  these  input  and 
output  functions  instead  of  more  complex  functions.  These  input  and  output 
functions  can  address  the  keyboard,  screen,  printer  and  serial  interface. 

The  functions  can  be  divided  into  two  types:  those  carried  over  from  the  CP/M 
operating  system  and  those  borrowed  from  the  UNIX  operating  system.  While  the 
two  types  of  functions  can  be  intermixed,  we  recommend  that  you  use  one  type  of 
function  throughout  a  program  for  the  sake  of  consistency. 

The  UNIX  type  functions  use  a  handle  as  an  identifier  to  a  device.  Because  of 
recent  DOS  trends  to  move  closer  to  UNIX,  you  may  want  to  give  the  handle 
functions  precedence. 

6.5.1  Handle  Functions 

The  handle  functions  perform  file  access  as  well  as  character  input  to  or  output 
from  a  device.  DOS  recognizes  the  difference  by  examining  the  name  assigned  by 
the  handle.  If  the  handle  is  a  device  name,  it  addresses  the  device;  otherwise  it 
assumes  that  file  access  should  occur.  The  device  names  are  as  follows: 

CON  Keyboard  and  display 
AUX  Serial  Interface 

PRN  Printer 

NUL  Imaginary  device  (nothing  happens  on  access) 

Output  and  input  go  to  and  from  the  AUX,  PRN  and  NUL  devices.  For  the  device 

CON,  output  is  sent  to  the  screen  and  input  is  read  from  the  keyboard. 

When  DOS  passes  control  to  a  program,  five  handles  are  available  for  access  to 
individual  devices.  These  handles  have  values  from  0  to  4  and  represent  the 
following  devices: 


EH! 

Standard  input  (CON) 

1 

Standard  output  (CON) 

2 

Standard  output  for  error  messages  (CON) 

3 

Standard  serial  interface  (AUX) 

4 

Standard  printer  (PRN) 

Here  is  a  short  example  to  help  demonstrate  the  use  of  this  table: 
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Display  error  message 

If  a  program  wants  to  accept  input  from  the  user,  the  handle  function  0  indicates 
this  during  the  call  since  the  standard  input  device  is  addressed.  Handle  0  normally 
represents  the  keyboard,  permitting  user  input  from  the  user  to  the  program.  Since 
the  user  can  redirect  standard  input,  you  can  redirect  input  to  originate  from  a  file 
instead  of  the  keyboard.  This  redirection  remains  hidden  from  the  program. 

Betee  discussing  these  devices,  here  are  some  functions  used  to  access  any  device. 

Function  40H  of  interrupt  21H  sends  data  to  a  device.  The  function  number  (40H) 
is  passed  in  the  AH  register  and  the  handle  is  passed  in  the  BX  register.  For 
example,  to  display  an  error  message,  the  value  2  indicates  the  handle  for 
displaying  the  error  message  (this  device  cannot  be  redirected,  so  handle  2  always 
addresses  the  console).  The  number  of  characters  to  be  in  the  error  message  is 
passed  in  the  CX  register.  The  characters  making  up  the  message  are  stored 
sequentially  in  memory  whose  segment  address  is  stored  in  the  DS  register  and 
offset  address  in  the  DX  register. 

Following  the  call  to  the  function,  the  carry  flag  signals  any  error.  If  there  was  no 
error,  the  carry  flag  is  reset  and  the  AX  register  contains  the  number  of  characters 
that  were  displayed.  If  the  AX  register  contains  the  value  0,  then  there  was  no 
more  space  available  on  the  storage  medium  for  the  message.  If  the  carry  flag  is 
set,  the  error  message  was  not  sent  and  an  error  code  is  indicated  in  the  AX 
register.  An  error  code  of  5  indicates  that  the  device  was  not  available.  An  error 
code  of  6  indicates  that  the  handle  was  not  opened. 

Function  3FH  of  interrupt  21H  reads  character  data  from  a  device  and  has  many 
similarities  to  the  previous  function.  Both  functions  have  identical  register  usage. 
The  function  number  is  passed  in  the  AX  register  and  the  handle  in  the  BX 
register.  The  number  of  characters  read  is  passed  in  the  CX  register  and  the 
memory  address  of  the  characters  transferred  are  passed  in  the  DS:DX  register  pair. 

Following  the  call  to  the  function,  the  carry  flag  also  signals  any  error.  Again,  any 
error  code  is  passed  in  the  AX  register.  Error  codes  5  and  6  have  the  same  meaning 
as  when  using  function  40H.  If  the  carry  flag  is  reset,  then  the  function  executed 
successfully.  The  AX  register  then  contains  the  number  of  characters  read  into  the 
buffer.  A  value  of  0  in  the  AX  register  means  that  the  data  to  be  read  should  have 
come  from  a  file,  but  that  this  file  contains  no  more  data. 

As  we  already  mentioned,  it’s  possible  to  redirect  the  input  or  output  when 
accessing  DOS.  For  example,  a  program  that  normally  expects  input  from  the 
keyboard  can  be  made  to  accept  the  input  from  a  file.  So,  to  avoid  having  input  or 
output  redirected,  you  can  open  a  new  handle  to  a  specific  device  which  insures  that 
the  transfer  of  data  to  or  from  the  desired  device  takes  place  instead  of  to  w  from  a 
redirected  device. 

Use  function  3DH  of  interrupt  21H  to  open  such  a  device. 
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The  function  number  3DH  is  passed  in  the  AH  regista*.  The  AL  register  contains  0 
to  enable  reading  from  the  device,  1  to  enable  writing  to  the  device  and  2  for  both 
reading  and  writing  to  the  device.  The  name  of  the  device  is  placed  in  memory 
whose  address  is  passed  in  the  DS:DX  register  pair.  So  that  the  DOS  can  properly 
identify  the  device  name,  the  names  must  be  specified  in  uppercase  characters.  The 
last  character  of  the  string  must  be  an  end  chamcter  (ASCII  value  0). 

Following  the  function  calls  the  status  is  indicated  by  the  carry  flag.  A  reset  flag 
means  that  the  device  was  opened  successfully  and  the  handle  number  is  passed 
back  in  the  AX  register.  A  set  flag  indicates  an  error  and  the  AX  register  contains 
any  OTOT  code. 

The  handle  is  closed  using  function  3EH  of  interrupt  21H.  The  function  number  is 
passed  in  the  AH  register  and  the  handle  number  is  passed  in  the  BX  register.  The 
carry  flag  again  indicates  the  status  of  the  function  call.  A  set  carry  flag  indicates 
anerrOT. 

You  can  also  close  the  predefined  handles  0  through  4  using  this  function.  But  if 
you  close  handle  0  (the  standard  input  device)  you’ll  no  longer  be  able  to  accept 
input  from  the  keyboard. 

Let’s  examine  the  speciel  characteristics  of  each  device. 

Keyboard 

The  keyboard  can  perfOTm  only  read  operations.  The  results  of  the  read  operations 
depend  on  the  mode  in  which  the  device  was  addressed.  Here  DOS  differentiates 
between  raw  and  cooked.  In  the  cooked  mode  DOS  checks  every  character  sent  to  a 
device  or  received  from  a  device  to  see  if  it  is  a  special  control  character.  If  DOS 
finds  a  special  control  character,  it  performs  a  certain  action  in  response  to  the 
character.  In  raw  mode  the  individual  characters  are  passed  through  unchecked  and 
unmanipulated.  DOS  normally  operates  the  device  in  cooked  mode  for  character 
input  and  output.  However,  you  can  switch  to  raw  mode  within  a  program  (see 
below). 

The  difference  between  codced  and  raw  mode  can  be  best  explained  by  an  example 
of  reading  the  keyboard.  Assume  that  30  characters  are  read  from  the  keyboard  in 
cooked  mode.  As  you  enter  the  characters  DOS  allows  you  to  edit  the  input  using 
several  of  the  control  keys.  For  example  <Ctrl><C>  and  <CtrlxBreak>  abort  the 
input.  <Ctrl><S>  temporarily  halts  the  program  until  another  key  is  pressed. 
<Ctrl><P>  directs  subsequent  data  from  the  screen  to  the  printer  (until  <Ctrl><P> 
is  pressed  again).  <Backspace>  removes  the  last  character  from  the  DOS  buffer.  If 
the  <Enter>  key  is  pressed,  the  first  30  characters  (or  all  characters  input  up  to 
now  if  there  are  less  than  30)  are  copied  from  the  DOS  buffer  into  the  input  buffer 
of  the  program  without  the  control  characters. 

In  raw  mode  all  characters  entered  (including  control  characters)  are  passed  to  the 
calling  program  without  requiring  the  user  to  press  the  <Enter>  key.  After  exactly 
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30  characters,  control  passes  to  the  calling  program,  even  if  you  pressed  the 
<Enter>  key  as  the  second  character  of  the  input. 


Screen 

To  display  characters  on  the  screen,  handle  1  is  usually  addressed  as  the  standard 
output  device.  Since  this  device  can  be  redirected,  output  through  this  handle  can 
pass  to  devices  other  than  the  screen.  On  the  other  hand,  you  cannot  redirect  the 
standard  error  output  device  (handle  2),  so  error  messages  that  pass  through  this 
handle  always  appears  on  the  screen.  This  handle  is  recommended  for  character 
display  on  the  screen  only. 

The  screen  is  normally  addressed  in  cooked  mode — every  character  displayed  on  the 
screen  is  tested  for  the  <Ctrl><C>  or  the  <Ctrl><Break>  control  characters.  This 
test  slows  down  the  screen  output,  so  sometimes  changing  to  raw  mode  decreases 
program  execution  time. 


Printer 


Unlike  the  keyboard  and  screen,  printer  output  cannot  be  redirected — at  least  not 
from  the  user  level.  An  exception  to  this  rule  is  redirecting  output  from  a  parallel 
printer  to  a  serial  printer.  Characters  ready  to  print  can  be  sent  to  a  buffer  before 
they  are  sent  to  the  printer.  Handle  4  is  used  to  address  the  standard  printer.  There 
are  three  standard  printer  devices  LPTl,  LPT2  and  LPT3.  Device  PRN  is 
synonymous  with  LFTl.  When  this  handle  is  opened  the  device  name  is  specified 
as  one  of  the  three:  LPTl,  LPT2  or  LPT3. 

Serial  interface 

Much  of  the  information  that  applies  to  the  printer  also  applies  to  the  serial 
interface.  For  example,  serial  input  and  output  cannot  be  redirected  to  another 
device  (e.g.,  from  a  serial  printer  to  a  parallel  printer).  The  programmer  can  use  the 
predefined  handle  3  for  serial  access,  through  which  you  can  address  the  standard 
serial  interface  (AUX). 

Handle  3  is  used  to  address  the  standard  serial  device.  The  two  are  names  COMl 
and  COM2.  A  PC  can  have  multiple  serial  interfaces.  Only  the  first  two  (COMl 
and  COM2)  are  supported  by  DOS.  Since  the  system  doesn’t  know  exactly  which 
interface  to  access  during  AUX  device  access,  you  should  open  a  new  handle  for 
access  to  the  specific  device. 

Errors  during  read  operations  in  DOS  mode  are  returned  to  the  serial  interface  in 
cooked  mode.  The  number  returned  to  the  AX  register  will  not  match  the  number 
of  characters  actually  read.  We  recommend  that  you  operate  the  serial  interface  in 
the  raw  mode,  even  if  this  mode  ignores  control  characters  such  as  <Ctrl><C>  and 
EOF  (end-of-file). 
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6.5.2  Traditional  DOS  Functions 

The  DOS  functions  for  input  and  output  aren’t  based  on  the  handle  oriented 
functions.  If  you  use  these  functions  you  won’t  need  to  specify  a  handle,  since 
each  function  pertains  to  a  specific  device. 

Below  are  the  various  input  and  output  devices  and  the  way  in  which  these 
functions  work  with  them. 

Keyboard 

There  are  seven  DOS  functions  for  addressing  the  keyboard  but  they  differ  in  many 
ways.  For  example,  they  respond  differently  to  the  <Ctrl>  <Break>  key.  Some 
functions  echo  the  characters  on  the  screen;  others  don’t. 

You  can  use  DOS  functions  OlH,  06H,  07H  and  OSH  to  read  a  single  keyboard 
character.  The  function  number  is  passed  in  the  AH  register.  Following  the  call, 
the  character  is  returned  in  the  AL  register. 

For  DOS  function  OlH,  DOS  waits  for  a  keypress  if  the  keyboard  buffer  is  empty. 
When  this  happens,  the  character  is  echoed  on  the  screen.  If  the  keyboard  buffer  is 
not  empty,  a  new  character  is  fetched  and  returned  to  the  calling  program.  DOS 
function  06H  can  be  used  for  both  character  input  and  output.  To  input  a  character 
a  value  of  FFH  is  loaded  into  the  DL  register.  This  function  doesn’t  wait  for  a 
character  to  be  input  but  returns  immediately  to  the  calling  program.  If  the  zero 
flag  is  set,  a  character  was  not  read.  If  the  zero  flag  is  reset,  a  character  was  read  and 
returned  in  the  AL  register.  The  character  is  not  echoed  on  the  screen. 

DOS  functions  07H  and  OSH  are  used  to  read  the  keyboard  similar  to  function  1. 
Both  either  fetch  a  character  from  the  keyboard  buffer  or  wait  for  a  character  to  be 
entered  at  the  keyboard.  Neither  echo  the  character  to  the  screen.  They  differ  in  that 
function  OSH  responds  to  <Ctrl><C>  and  function  07H  does  not. 

By  using  function  OBH,  a  program  can  determine  whether  one  or  more  characters 
are  in  the  keyboard  buffer  before  calling  any  functions  that  read  characters.  After 
calling  this  function,  the  AL  register  contains  0  if  the  keyboard  buffer  is  empty, 
and  FFH  if  the  keyboard  buffer  is  not  empty. 

DOS  function  OCH  is  used  to  clear  the  keyboard  buffer.  After  it  is  cleared,  the 
function  whose  number  was  passed  to  function  OCH  in  the  AL  registered  is 
automatically  called. 

DOS  function  OAH  is  used  to  read  a  string  of  characters.  Again  this  function 
number  is  passed  in  the  AH  register.  In  addition,  the  memory  address  of  a  buffer 
for  the  character  string  is  passed  in  the  DSrDX  register  pair.  This  buffer  is  used  to 
hold  the  character  string.  The  first  byte  of  the  buffer  indicates  the  maximum 
number  of  characters  that  may  be  contained  in  the  buffer. 
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When  this  function  is  called,  DOS  reads  up  to  the  maximum  number  of  characters 
and  stores  them  in  the  buffer  starting  at  the  third  byte.  It  reads  until  either  the 
maximum  number  of  characters  is  entered  or  the  <Enter>  key  is  pressed.  The 
actual  number  of  characters  is  stored  in  the  second  byte  of  the  buffer.  Extended  key 
codes  which  occupy  two  bytes  each  in  the  buffer  may  be  entered.  The  first  byte  of 
the  pair  (ASCII  value  0)  signifies  that  an  extended  key  code  follows.  This  means, 
for  example,  that  for  a  maximum  buffer  size  of  10  bytes,  only  five  extended 
characters  may  be  entered. 

The  following  table  illustrates  how  the  various  functions  respond  to  <CtrlxC> 
or  <Ctrl><Break>,  and  provides  a  quick  overview  of  the  individual  functions  for 
character  input 


fS9B 

Task  1 

<Ctrl><C> 

Echo 

ESxHI 

yes 

yes 

no 

no 

|07H 

no 

no 

Character  input 

yes 

no 

esiih 

Character  string  input 

yes 

no 

Read  input -status 

yes 

no 

Reset  input-buffer  then  input 

varies 

varies 

Screen  output 

There  are  three  DOS  functions  for  character  output 

DOS  function  02H  outputs  a  single  character  to  the  screen  or  standard  output 
device.  The  character  is  passed  to  the  DL  register. 

DOS  function  06H  which  is  multi-purpose  is  also  used  to  output  a  single 
character.  The  character  is  passed  in  the  DL  register.  You  can  see  that  the  character 
whose  value  is  255  cannot  be  output  since  this  indicates  that  the  function  is  to 
perform  an  input  operation.  Output  using  this  function  is  faster  than  using 
function  02H  since  it  doesn’t  test  for  the  <Ctrl><C>  or  <Ctrl><Break>  keys. 

DOS  function  09H  is  used  for  string  output.  Again,  the  function  number  is  passed 
in  the  AH  register.  The  address  of  the  string  is  passed  in  the  DS:DX  register  pair. 
The  last  character  of  the  string  is  a  dollar  sign.  In  addition,  the  following  control 
codes  are  recognized. 


Operation  | 

7 

8 

"Backspace",  erases  the  preceding  character  and  moves  the  cursor 
back  by  one  character 

fSM 

"Line  Feed",  (LF)  moves  the  cursor  one  line  down 

"Carriage  Return",  (CR)  moves  the  cursor  to  the  beginning  of  the 
current  line 

As  with  function  02H,  this  function  also  checks  for  <Ctrl><C>  or 
<Ctrl><Break>. 
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Printer 


DOS  function  OSH  is  used  to  output  a  single  character  to  the  printer.  If  the  printer 
is  busy,  this  function  waits  until  it  is  ready  before  returning  control  to  the  calling 
program.  During  this  time,  it  will  respond  to  the  <Ctrl><C>  and  <Ctrl><Break> 
keys. 

The  function  number  is  passed  in  the  AH  register.  The  character  to  output  is 
passed  in  the  DL  register.  The  status  of  the  printer  is  not  returned.  Most 
programmers  will  elect  to  use  the  BIOS  function  instead  of  the  DOS  function  for 
printer  output  since  you  can  specify  the  exact  printer  device  and  determine  the 
printer  status  using  the  BIOS  version.  See  Section  7.12  for  more  detailed 
information. 

Serial  interface 

There  are  two  DOS  functions  for  communicating  using  serial  interface — one  for 
input  and  one  for  output.  Both  functions  respond  to  <Ctrl><C>  and 
<Ctrl><Break>,  but  they  don’t  return  the  status  of  the  serial  interface,  nor  do  they 
recognize  transmission  errors. 

DOS  function  03H  is  used  to  input  data  from  the  serial  interface.  The  character  is 
returned  in  the  AL  register.  Since  the  data  is  not  buffered,  the  data  can  overrun  the 
interface  if  the  interface  receives  data  faster  than  this  function  can  handle  it 

DOS  function  04H  is  used  to  output  data  over  the  serial  interface.  The  character  to 
output  is  passed  in  the  DL  register.  If  the  serial  interface  is  not  ready  to  accept  the 
data,  this  function  waits  until  it  is  free. 

Again,  most  programmers  prefer  to  use  the  BIOS  equivalent  functions  (see  Section 
7.9)  to  perform  serial  data  transmission  because  of  their  more  complete  data 
handling  capabilities. 

Demonstration  programs 

Earlier  we  mentioned  that  it  was  possible  to  switch  a  device  from  cooked  mode  to 
raw  mode  and  back.  The  BASIC,  Pascal  and  C  programs  that  follow  show  you 
how  to  do  this.  They  use  the  lOCTL  functions  which  permit  access  to  the  DOS 
device  drivers  (see  Section  6.11.7  for  details  on  this  routine).  These  are  routines 
which  serve  as  interfaces  between  the  DOS  input/output  functions  and  the 
hardware.  The  lOCTL  functions  in  these  programs  tell  the  CON  device  driver 
(responsible  for  the  keyboard  and  the  display)  whether  it  should  operate  in  the 
cooked  mode  or  in  the  raw  mode. 

To  demonstrate  how  differently  characters  respond  in  the  two  modes,  the  programs 
switch  the  CON  driver  into  raw  mode  first.  Then  this  driver  displays  a  sample 
string  several  times.  Unlike  cooked  mode,  pressing  <Ctrl><C>  or  <Ctrl><S>  in 
raw  mode  has  no  effect  on  stopping  program  execution  or  text  display. 
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After  the  program  finishes  displaying  the  sample  string,  the  driver  switches  to  the 
cooked  mode.  The  sample  string  is  displayed  again  several  times.  When  you  press 
<Ctrl><C>  the  program  stops  (Turbo  Pascal  version).  For  the  BASIC  and  C 
versions,  you  can  press  <Ctrl><C>  to  stop  the  program,  or  press  <Ctrl><S>  to 
pause  or  continue  the  display. 


Switching  between  the  raw  and  the  cooked  mode  does  not  take  place  directly 
through  a  function.  First  the  device  attribute  of  the  driver  is  determined.  This 
attribute  contains  certain  information  which  identifies  the  driver  and  describes  its 
method  of  operation.  One  bit  in  this  word  indicates  if  the  driver  operates  in  raw  or 
cooked  mode.  The  programs  set  or  reset  this  bit,  depending  on  the  mode  you  want 
running  the  driver. 

BASIC  listing:  RAWCOOK.BAS 


100 

110 

120 

130 

140 

150 

160 

170 

180 

190 

200 

210 

220 

230 

240 

250 

260 

270 

280 

290 

300 

310 

320 

330 

335 

340 

345 

350 

360 

365 

370 

380 

390 

400 

410 

420 

425 

430 

440 


•  ****************************************************** ***********  I 

**  RAWCOOK  *• 


'*  Task  ;  make  two  subroutines  available  *' 
'*  to  switch  the  character  driver  into  RAW-  or  *' 
'*  COOKED  mode  *' 
'*  Author  :  MICHAEL  TISCHER  *' 
•*  developed  ;  07/23/87  *• 
•*  last  Update  :  04/08/89  *• 
!*****************************************************************• 


CLS  :  KEY  OFF 

PRINT"WARNING:  This  program  can  only  be  started  if  the  GWBASIC  was” 
PRINT "started  from  DOS  with  the  command  <GWBASIC  /m:60000>.” 

PRINT  :  PRINT”If  this  is  not  the  case,  please  input  <s>  for  Stop." 
PRINT"Otherwise  press  any  key...”; 

A$  =  INKEY$  :  IF  A$  =  ”s”  THEN  END 
IF  A$  =  ”"  THEN  260 

GOSUB  60000  'Install  function  for  interrupt  call 

CLS  'erase  display 

HANDLE%  =  0  'handle  is  connected  with  console  driver 

PRINT''RAWCOOK  (c)  1987  by  Michael  Tischer”  :  PRINT 
PRINT''The  Console  driver  (Keyboard  and  Display)  is  now  in  RAW-” 
PRINT''Mode  so  that  during  input  and  output  no  control  characters  ” 
PRINT"are  recognized.” 

PRINT''Because  of  this  not  even  <CTRL>  +  <S>  can  stop  the  " 
PRINT''following  output." 

PRINT''Try  it  ...”  :  PRINT 

PRINT  "Press  any  key  to  start  output  ...” 

GOSUB  25000  'Clear  keyboard  buffer 

A$  =  INKEY$  :  IF  A$  -  '"'  THEN  370  'wait  for  a  key 

GOSUB  52000  'Switch  console  driver  into  RAW  mode 

GOSUB  50000  'Output  Test-String 

CLS 

PRINT''The  Console  driver  (Keyboard  and  Display)  is  now  in  ” 
PRINT''COOKED  mode.  Control  characters  will  be  recognized  during  " 
PRINT” input /output . ” 

PRINT”The  following  output  can  be  stopped  with  <CTRL>  +  <S>.” 
PRINT"Try  it  ...”  :  PRINT 
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'*  Input  :  none  *' 

Output:  none 

***********  *******11  **********************  ********** 


T$  =  "Test _ " 

FOR  I  =  1  TO  250 
FCT%  =  &H40  :  FCT1%  =  0 
INR%  =  &H21 

ADRLO%  =  9  :  ADRHI%  =  0 
OFSLO%  =  PEEK(VARPTR(T$)+1) 
OFSHI%  =  PEEK(VARPTR(T$)+2) 
HANDLO%  =  1:  HANDHI%  =  0 


450  PRINT  "Press  any  key  to  start  the  output...” 

455  GOSUB  25000  'Clear  the  keyboard  buffer 

460  A$  *  INKEY$  :  IF  A$  «  ""  THEN  460  'wait  for  a  key 

470  GOSUB  51000  'change  console  driver  to  the  COOKED  mode 

480  GOSUB  50000  'output  Test-String 

490  CLS 
500  END 
510  ' 

25000  A$  -  INKEYS  :  IF  A$  =  ""  THEN  RETURN  'Clear  the  keyboard  buffer 
25010  goto  25000 

50000  '*************************************★**★*****************★****• 
50010  '*  outputs  a  Test-String  on  the  Standard  output  device  *' 

50020  - *• 

50030 
50040 
50050 
50060 
50070 
50080 
50090 
50100 
50110 
50120 
50130 
50140 
50150 

50160 
50170 
50180 
50190 
51000 
51010 
51020 
51030 
51040 
51050 
51060 
51070 
51080 
51090 
51100 
51110 
52000 
52010 
52020 
52030 
52040 
52050 
52060 
52070 
52080 
52090 
52100 
52110 
53000 
53010 
53020 
53030 
53040 
53050 


•Output  Test -String 
'250  times 

•Write  function  number  for  handle 
•Call  DOS-Interrupt  21H 
•output  9  characters  at  a  tin^ 
LO-byte  of  offset  address  of  string 
•Hl-byte  of  offset  address  string 
•address  the  standard  output  device 
CALL  IA(INR%,FCT%, FCTl%,HANDHI%,HANDLO%,ADRHI%,ADRLO%,OFSHI%, 
OFSLO%,Z%,Z%,Z%,Z%) 

NEXT  ' next  run 

PRINT 

RETURN  'back  to  caller 

I***************************************************************! 

'*  change  device  driver  to  COOKED  mode  *' 

•  —  —  —  _ _ _ _ _ _ _  _ _ * 

'*  Input  :  HANDLE%  *  handle  connected  with  the  driver  *' 

' *  Output :  none  * ' 

**********************  ■i,*i,-kifi,* -kit  ******  ********-t(******************* 


GOSUB  53000 

ATTRIB%  =  ATTRIB%  AND  223 

GOSUB  54000 

RETURN 


'Get  device  attribute  of  driver 
•Find  COOKED-Bit 
•Set  device  attribute  of  driver 
•back  to  caller 


***************************************************************** 
'*  change  device  driver  to  RAW  mode  *' 


'*  Input  :  HANDLE%  =  handle  connected  to  the  driver  *' 
' *  Output :  none  * ' 
***************************************************************** 


GOSUB  53000 

ATTRIB%  =  ATTRIB%  OR  32 

GOSUB  54000 

RETURN 


•Get  device  attribute  of  driver 
•Set  RAW-Bit 
•Set  device  attribute  of  driver 
•back  to  caller 


I  ★*★★*★★★***★***★«*«*«*«******«*****«***********************★*** I 

'*  Get  device  attribute  of  a  driver  *' 

'  * - *  • 

'  *  Input  :  HANDLE%  =  handle  connected  with  a  driver  * ' 

'*  Output:  ATTRIB%  =  Attribute  of  driver  *' 

'*  Info  :  Z%  used  as  Duinny-Variable  *' 
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53060 

53070 

53080 

53090 

53100 

53110 

53120 

53130 

53140 

53150 

53160 

53170 

54000 

54010 

54020 

54030 

54040 

54050 

54060 

54070 

54080 

54090 

54100 

54110 

54120 

54130 

54140 

54150 

54160 

54170 

54180 

60000 

60010 

60020 

60030 

60040 

60050 

60060 

60070 

60080 

60090 

60100 

60110 

60120 

60130 

60140 

60150 

60160 

60170 

60180 

60190 

60200 

60210 

60220 

60230 


'*  only  Bits  0  to  7  of  the  device  attribute  *' 

'*  determined  *' 

I***************************************************************' 


FCT%=&H44  'Function  number  for  lOCTL 

FCT1%=0  'Read  Function  number  for  lOCTL;  Read  device  attribute 
INR%“&H21  'Call  DOS-Interrupt  21H 

HANDHI%  «  INT(HANDLE%/256)  'Hl-byte  of  the  handle 

HANDLO%  -  HANDLE%  AND  255  'LO-byte  of  the  handle 

CALL  lA (INR%, FCT%, FCT1%, HANDHI%, HANDLO%, Z%, Z%, Z%, ATTRIB%, Z%, Z%, Z%, Z%) 
RETURN  'back  to  caller 

'*  Set  device  attribute  of  a  driver  *' 

•  * _ *  • 

'*  Input  :  HANDLE%  =  handle  connected  to  a  driver  *' 

'*  ATTRIB%  =  the  attribute  of  the  driver  *' 

' *  Output :  none  * ' 

' *  Info  :  Z%  used  as  Dummy-Variable  * ' 

•***************************************************************' 


FCT%=&H44  'Function  number  for  lOCTL 

FCT1%=1  'Set  function  number  for  lOCTL:  device  attribute 

INR%=&H21  'Call  DOS-Interrupt  21(h) 

HANDHI%  =  INT(HANDLE%/256)  'Hl-byte  of  the  handle 

HANDLO%  =  HANDLE%  AND  255  'LO-byte  of  the  handle 

ATHI%  =  INT(ATTRIB%/256)  'Hl-byte  of  the  Attribute 

ATLO%  =  ATTRIB%  AND  255  'LO-byte  of  the  Attribute 

CALL  lA (INR%, FCT%, FCT1%, HANDHI%, HANDLO%, Z%, Z%, ATHI%, ATLO%, Z%, Z%, Z%, Z%) 
RETURN  'back  to  caller 


**************************************************************** 
*  Initialize  the  Routine  for  Interrupt  Call  *' 


*  Input  :  none  *' 

*  Output:  lA  is  the  Start  address  of  the  Interrupt-Routine 
**************************************************************** 


IA=60000!  'Start  address  of  the  routine  in  the  BASIC-Segment 

DEF  SEG  'Set  BASIC-Segment 

RESTORE  60130 

FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'Poke  Routine 
RETURN  'back  to  caller 

DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 

DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 

DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 
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Pascal  listing:  RAWCOOK.PAS 


{*  RAWCOOK  *} 

(* - *j 

i*  Task  :  provide  two  functions  to  switch  *} 

i*  a  character  device  driver  to  the  RAW-  *] 

{*  or  the  COOKEa)  mode  *} 

{* - 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  :  08/16/87  *} 

{*  last  Update  :  05/11/89  *} 


program  RAWCOOKP; 

Uses  Crt,  Dos; 

const  STANDARDIN  =  0; 

STANDARDOUT  *  1; 

var  Keys  :  char; 


{  CRT  and  DOS  units  } 

{  handle  0  Is  connected  with  Standard  Input  } 
{  handle  1  Is  connected  with  Standard  output  } 

{  only  needed  for  Demo  program  } 


{********-*************************************************************j 

{*  GETMODE:  read  attribute  of  device  driver  In  *} 

{*  Input  :  the  handle  passed  must  be  connected  to  device  addressed  *} 
{*  Output  :  the  device  attribute  *} 

^ ************************************************************ ******<^**j 


function  GetMode (Handle  :  Integer)  :  Integer; 

var  Regs  :  Registers;  {  register-variable  for  Interrupt  call  } 

begin 

Regs. ah  :=  $44; 

Regs.bx  :=  Handle; 

MsDos  (  Regs  ) ; 

GetMode  :=  Regs.dx 
end; 

I ****★*★**★★*★★*★★*★**★*★★★*★**★*★**★★*★★*★**★**★*★**★*★★★**★*★*★★**★* j 


{*  SETRAW  :  Change  a  character  driver  Into  RAW-Mode  *} 
{*  Input  :  the  handle  passed  must  be  connected  with  *} 
{*  addressed  device  *} 
{*  Output  :  none  *) 


{  Function  number  for  lOCTL:  Get  Mode  } 

{  Call  DOS-Interrupt  21H  ) 

{  Pass  device  attribute  } 


procedure  SetRaw (Handle  ;  Integer); 

var  Regs  :  Registers;  {  reglster-Varlable  for  Interrupt  call  ) 

begin 

Regs. ax  :=  $4401; 

Regs.bx  :=  Handle; 

Regs.dx  :=  GetMode (Handle) 

MsDos (  Regs  ) ; 
end; 

(*********************************************************************j 


{*  SETCOOKED  :  Change  a  character  driver  Into  the  COOKED-Mode  *} 
{*  Input  :  the  handle  passed  must  be  connected  with  the  *} 
{*  device  addressed  *} 
{ *  Output  :  none  * } 


procedure  Set Cooked (Handle  :  Integer); 

var  Regs  :  Registers;  {  reglster-Varlable  for  Interrupt  call  } 


{  Function  number  for  lOCTL:  Set  Mode  } 

and  255  or  32;  {  new  device  attribute  } 

{  Call  DOS-Interrupt  21H  } 
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begin 

Regs. ax  :=  $4401;  {  Function  number  for  lOCTL:  Set  Mode  } 

Regs.bx  :=  Handle; 

Regs.dx  :*  GetMode (Handle)  and  223;  {  new  device  attribute  } 

MsDos(  Regs  );  {  Call  DOS-Interrupt  21H  } 

end; 

^ ******************************************** ************* ****** *★**★*} 
{*  TESTOUTPUT  :  Output  a  Test-String  1000  times  on  the  Standard  *} 

{*  output  device  *} 

{*  Input  :  none  *} 

{*  Output  :  none  *} 

I*********************************************************************} 


procedure  TestOutput; 

var  Regs  :  Registers; 
LoopCnt  :  integer; 
Test  :  string [9]; 


register- Variable  for  Interrupt  call  } 
{  Loop  variable  } 
{  The  Test-String  for  output  } 


begin 

Test  :=  'Test....  '; 

Regs.bx  :*  STANDARDOUT; 
Regs.cx  :*  9; 

Regs.ds  ;=  Seg(Test); 
Regs.dx  :=  Ofs(Test)+l; 
for  LoopCnt  :=  1  to  1000  do 
begin 

Regs. ah  :=  $40; 

MsDos (  Regs  ) ; 
end; 

writeln; 

end; 


output  on  the  Standard  output  device  } 
{  Number  of  characters  } 
{  Segment  address  of  the  text  } 
{  Offset  address  of  the  text  } 


{  Write  function  number  for  handle  } 
{  Call  DOS-Interrupt  21H  } 


I  ********************************************************************* ^ 

{*  MAIN  PROGRAM  *} 

^*********************************************************************^ 


begin 

ClrScr;  {  Clear  screen  } 

writeln ('RAWCOOK  (c)  1987  by  Michael  Tischer' #13#10> ; 

writeln ('The  Console  driver  is  now  in  RAW-Mode.  Control  keys  such  as  <Ctrl><C>'); 
writeln ('are  not  recognized  during  output.  Press  a  key  to  display  a  text  on 
'#13#10)  ; 

writeln('the  screen,  and  try  stopping  the  display  by  pressing  <Ctrl><C>'); 

{  wait  for  key  } 

{  Console  driver  in  RAW  mode  } 
t  Output  Test-String  1000  times  } 

{  Clear  Screen  } 


Keys  :»  ReadKey; 

Set Raw (STANDARDIN) ; 
TestOutput; 

ClrScr; 

while  KeyPressed  do 
Keys  :=  ReadKey; 


{  Empty  keyboard  buffer  } 
writeln ('The  Console  driver  is  now  in  COOKED  mode.  Control  keys  such  as'); 
writeln ('<CTRL><C>  are  recognized  during  output'); 

writeln  ('Press  a  key  to  start,  then  press  <Ctrl><C>  to  stop  the  display'); 


Keys  :=  ReadKey; 
SetCooked (STANDARDIN) ; 
TestOutput; 
end. 


{  Wait  for  key  } 
{  Output  Test-String  1000  times  } 


81 


6.  The  Disk  Operating  System 


PC  System  Programming 


C  listing:  RAWCOOK.C 


/★**★*★*★**★*★★*****★*★****★**★***★**★**★★**★*★*★**★★★**★**★*★*★*★**★*/ 


/* 

/*- 

/* 

/* 

/* 

/*- 

/* 

/* 

/* 

/*- 

/* 

/* 

/* 

/* 

/*- 

/* 

/* 


R  A  W  C  0  0  K 


provides  two  functions  for 


Author 
developed  on 
last  Update 

(MICROSOFT  C) 
Creation  ; 

Call  : 


*/ 

- */ 

*/ 

switching  a  character  device  driver  into  the  RAW  */ 
or  into  the  COOKED  mode 

:  MICHAEL  TISCHER 
:  08/16/87 
:  04/08/89 


MSC  RAWCOOKC; 
LINK  RAWCOOKC; 
RAWCOOKC 


(BORLAND  TURBO  C) 

Creation  :  through  command  RUN  in  the  menu 


/★*★*★**★*★*★★*★*★★★******★*★**★*★*★★***★******★**★*★****★***★★*★* 


— */ 
*/ 
*/ 
*/ 

— */ 
*/ 
*/ 
*/ 
*/ 

— */ 
*/ 
*/ 

»**★/ 


♦include  <dos.h>  /*  Include  Header  files  */ 

♦include  <stdio.h> 

♦include  <conio.h> 

♦define  STANDARDIN  0  /*  handle  0  is  the  Standard  input  device  */ 

♦define  STANDARDOUT  1  /*  handle  1  is  the  Standard  output  device  */ 

/*********************************************************************/ 
/*  GETMODE:  read  the  attribute  of  an  device  driver  */ 

/*  Input  :  the  handle  must  be  connected  with  the  addressed  device  */ 
/*  Output  :  the  device  attribute  */ 

/************************★****★********★**★*★****★****★**★***★★***★★*★/ 


int  GetMode (Handle) 

int  Handle;  /*  points  to  the  character  driver  */ 

{ 

union  REGS  Register;  /*  register-variable  for  Interrupt  call  */ 

Register. X. ax  =  0x4400;  /*  Function  number  for  lOCTL:  Get  Mode  */ 

Register. x.bx  =  Handle; 

intdos (^Register,  &Register);  /*  Call  DOS-Interrupt  21H  */ 

return (Register. x.dx) ;  /*  Pass  device  attribute  */ 

} 

/***********★*********************************************************/ 


/*  SETRAW  :  Change  a  character  driver  into  RAW  mode  */ 
/*  Input  :  the  handle  passed  must  be  connected  with  the  addressed  */ 
/*  device  */ 
/*  Output  :  none  */ 


/★★*****★*******★***★★*****★*********★*★******★**★****★*★****★******★*/ 


int  SetRaw (Handle) 

int  Handle;  /*  points  to  the  character  driver  */ 

{ 

union  REGS  Register;  /*  register-variable  for  Interrupt  call  */ 

Register. X. ax  =  0x4401;  /*  Function  number  for  lOCTL:  Set  Mode  */ 

Register .x.bx  =  Handle; 

Register. x.dx  =  GetMode (Handle)  &  255  |  32;  /*  new  device  attribute  */ 
intdos (&Register,  &Register) ;  /*  Call  DOS-Interrupt  21H  */ 

} 
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/****** *************************** ************************************/ 


/*  SETCOOKED:  Changes  a  character  driver  into  the  COOKED  mode  */ 
/*  Input  ;  the  handle  passed  must  be  connected  with  the  device  */ 
/*  addressed  */ 
/*  Output  ;  none  */ 


/*********************************************************************/ 
int  Set Cooked  (Handle) 

int  Handle;  /*  points  to  the  character  driver  */ 

{ 

union  REGS  Register;  /*  register-variable  for  Interrupt  call  */ 

Register.x.ax  =  0x4401;  /*  Function  number  for  lOCTL:  Set  Mode  */ 

Register .x.bx  *  Handle; 

Register. x.dx  =  GetMode (Handle)  &  223;  /*  new  device  attribute  */ 

Intdos (^Register,  ^Register);  /*  Call  DOS-Interrupt  21H  */ 

} 

/*********************************************************************/ 


/* 

TESTOUTPUT: 

outputs  a  Test-String  1000  times  on  the  Standard 

*/ 

/* 

output  device 

*/ 

/* 

Input  : 

none 

*/ 

/* 

Output  : 

none 

*/ 

/*********************************************************************/ 
void  Test Output () 

{ 

int  1;  /*  Loop  Variable  */ 

static  char  Test[]  =  "Test....  /*  the  text  for  output  */ 

print f  C'Xn”) ; 

for  (1  =  0;  1  <  1000;  1++)  /*  output  1000  times  */ 

fputs(Test,  stdout);  /*  Output  String  on  the  Standard  output.  */ 

print f  ('*\n'*) ; 

} 

/*********************************************************************/ 
/**  MAIN  PROGRAM  **/ 

/****************************★****************************************/ 

void  main  () 

{ 

prlntf  C'XnRAWCOOK  (c)  1987  by  Michael  Tischer\n\n'')  ; 

prlntfC'The  Console  Driver  (Keyboard,  Display)  is  now  in  •*); 
prlntf ("RAW  Mode. \nDurlng  the  following  output  control  characters, \n") ; 
prlntf ("such  as  <CTRL-S>  will  not  be  recognlzed.Xn") ; 
prlntf ("Try  lt.\n\n"); 

prlntf ("Please  press  a  key  to  start..."); 

getchO;  /*  wait  for  key  */ 

SetRaw(STANDARDIN) ;  /*  Console  driver  into  RAW  mode  */ 

TestOutput ( ) ; 

while  (kbhitO)  /*  in  the  meantime  remove  key  codes  from  */ 

getchO;  /*  keyboard  buffer  */ 

prlntf ("\nThe  console  driver  is  now  in  COOKED  mode.  "); 
prlntf ("Control  ke^s  such  as\n<CTRL-S>  are  recognized  during  "); 
prlntf ("output  and  answered  accordingly! \n") ; 
prlntf ("Please  press  a  key  to  start  ..."); 

getchO;  /*  wait  for  key  */ 

SetCooked(STANDARDIN) ;  /*  Console  driver  in  the  COOKED  mode  */ 

TestOutput ( ) ; 
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6.6  File  Management  in  DOS 

The  DOS  file  management  functions  are  among  the  most  basic  available  to  the 
programmer.  These  functions  are  used  to: 

•  Create  and  delete  files 

•  Open  and  close  files 

•  Read  from  and  write  to  files 

Operating  systems  such  as  DOS  provide  the  programmer  with  functions  for  file 
management.  For  example,  DOS  provides  functions  which  return  special  file 
information  or  functions  to  rename  a  file.  One  peculiarity  of  DOS  is  that  these 
functions  exist  in  two  forms  because  of  the  combined  CP/M  &  UNIX 
compatibility.  For  every  UNIX  compatible  file  function,  there  is  also  a  CP/M 
compatible  file  function. 

FCB  functions 

The  CP/M  compatible  functions  are  designated  as  FCB  functions  since  they  are 
based  on  a  data  structure  called  the  FCB  (File  Control  Block).  DOS  uses  this  data 
structure  for  information  storage  during  file  manipulation.  The  user  must  reserve 
space  for  the  FCB  within  this  program.  The  FCB  permits  access  to  the  FCB 
functions  which  open,  close,  read  from  and  write  to  files. 

Since  the  FCB  functions  were  developed  for  compatibility  with  CP/M's  functions, 
and  since  CP/M  has  no  hierarchical  file  system,  FCB  functions  do  not  support 
paths.  As  a  result,  FCB  functions  can  only  access  files  which  are  in  the  current 
directory. 

UNIX  handle  functions 

The  UNIX  compatible  handle  functions  don’t  have  this  problem.  With  these 
functions,  a  handle  is  used  to  identify  the  file  to  be  accessed.  The  DOS  stores 
information  about  each  open  file  in  an  area  that  is  separate  from  the  program. 

6.6.1  Handle  Functions 

It  is  easier  for  the  programmer  to  access  a  file  using  the  handle  functions  than  to 
access  a  file  using  the  FCB  functions.  The  handle  functions  do  not  require  a 
programmer  to  use  a  data  structure  for  file  access  like  the  FCB  functions  do.  In  a 
manner  similar  to  the  functions  of  the  UNIX  operating  system,  file  access  is 
performed  using  a  filename.  The  filename  is  passed  as  an  ASCII  string  when  the 
file  is  opened  or  first  created.  This  must  be  performed  before  the  first  write  or  read 
operation  to  the  file.  In  addition  to  the  filename,  it  may  contain  a  device 
designator,  a  pathname  and  a  file  extension.  The  ASCII  string  ends  with  the  end 


84 


Abacus 


6.6  File  Management  in  DOS 


character  (ASCII  code  0).  After  the  file  is  opened,  a  numeric  value  called  the  handle 
is  returned.  Any  further  operations  to  this  file  are  performed  using  this  16-bit 
handle.  For  a  subsequent  read  or  write  operation,  the  handle  and  not  the  filename  is 
passed  to  the  appropriate  function. 

For  each  open  file,  DOS  saves  certain  information  pertaining  to  that  file.  If  the 
FCB  functions  are  used,  DOS  saves  the  information  in  the  FCB  table  within  the 
program's  memory  block.  When  the  handle  functions  are  used,  the  information  is 
stored  in  an  area  outside  of  the  program's  memory  block  in  a  table  that  is 
maintained  by  the  DOS.  The  number  of  open  files  is  therefore  limited  by  the 
amount  of  available  table  space.  The  amount  of  table  space  set  aside  by  DOS  is 
specified  by  the  FILES  parameter  of  the  CONFIG.SYS  file: 

FILES  =  X 

In  DOS  Version  3.0,  this  maximum  is  255.  If  you  change  the  maximum  number 
of  files  in  the  CONFIG.SYS  file,  the  change  will  not  go  into  effect  until  the  next 
time  that  DOS  is  booted. 


FILES 


While  the  FILES  parameter  specifies  the  maximum  number  of  open  files  for  the 
entire  operating  system,  DOS  limits  the  number  of  open  files  to  20  per  program. 
Since  five  handles  are  assigned  to  standard  devices  such  as  the  keyboard,  monitor 
and  line  printer,  only  15  handles  are  available  for  the  program.  For  example,  if  a 
program  opens  three  files,  DOS  assigns  three  available  hicndles  and  reduces  the 
number  of  additional  handles  available  by  three.  If  this  program  calls  another 
program,  the  three  files  opened  by  the  original  program  remain  open.  If  the  new 
program  opens  additional  files,  the  remaining  number  of  handles  available  is 
reduced  even  fiirthCT. 

In  addition  to  the  standard  read  and  write  functions,  there  is  also  a  file  positioning 
function.  This  lets  you  specify  an  exact  location  within  the  file  for  the  next  data 
access.  Knowing  both  a  record  number  and  the  length  of  each  data  record  allows 
you  to  specify  the  position  to  access  a  particular  data  record: 

position  =  record  number  *  length  of  record 


This  function  is  not  used  during  sequential  file  access  since  DOS  sets  the  file 
pointer  during  opening  or  creation  of  a  file  to  the  first  byte  within  the  file.  Each 
subsequent  read  or  write  operation  moves  the  file  pointer  by  the  number  of  bytes 
read  towards  the  end  of  the  file  so  that  the  next  file  access  starts  where  the  previous 
one  ended. 

The  following  table  summarizes  the  handle  functions.  For  a  more  detailed 
description  of  these  functions,  see  Appendix  C. 
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Function  No. 

Operation 

3CH 

Create  file 

3DH 

Open  file 

3EH 

Close  file 

42H 

Move  file  pointer/determine  file  size 

43H 

Read/Write  file  attribute 

56H 

Rename  file 

57H 

Read/Write  modifications  &  date/time  of  file 

Here  are  a  few  general  rules  to  follow  when  using  these  functions: 

Functions  which  expect  a  filename  or  the  address  of  a  filename  as  an  argument 
(e.g..  Create  File  and  Open  File)  expect  the  segment  address  of  the  name  in  the  DS 
register  and  the  offset  address  in  the  DX  register.  If  the  function  successfully 
returns  a  handle,  it  is  returned  in  the  AX  register. 

Functions  which  expect  a  handle  as  an  argument  expect  it  in  the  DX  register.  After 
the  call,  the  carry  flag  indicates  if  an  error  occurred  during  execution.  If  an  error 
occurs,  the  carry  flags  is  set  and  the  error  code  is  returned  in  the  AX  register. 

Function  59H  of  DOS  interrupt  21H  returns  very  detailed  information  concerning 
errors  which  occur  during  disk  operations.  This  function  is  available  only  in  DOS 
Versions  3.0  and  higher. 


6.6.2  FCB  Functions 

As  discussed  earlier,  DOS  uses  an  FCB  data  structure  for  managing  a  file.  The 
programmer  can  use  this  data  structure  to  obtain  information  about  a  file  or  change 
information  about  a  file.  For  this  reason  we  shall  examine  the  structure  of  an  FCB 
before  discussing  the  individual  FCB  functions. 

The  FCB  is  a  37-byte  data  structure  which  can  be  subdivided  into  different  data 
fields.  The  following  figure  illustrates  these  fields. 
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+  OOH 

Device  name  (1  byte) 

+  OlH 

Filename  (8  bvtes) 

+  09H 

File  mode  (3  bvtes) 

+  OCH 

Current  block  number  (1  word) 

+  OEH 

Data  record  size  (1  word) 

+  lOH 

File  size  (2  words) 

DBSII 

Modification  date  (1  word) 

+  16H 

Modification  time  (1  word)  / 

+  18H 

Reserved  (8  bytes)  1 

+  20H 

Current  data  record  number (1  byte)  j 

+  21H 

Data  record  number  for  (2  words) 

random  access 

RAM 

0000:0000 

1 


Structure  of  an  FCB 

I^otice  that  the  name  of  the  file  is  found  beginning  at  offsets  OlH  through  OBH  of 
the  FCB.  The  byte  at  offset  0  is  the  device  indicator,  0  is  the  current  drive,  1  drive 
A,  2  drive  B,  etc. 

The  filename  which  begins  at  offset  1  is  an  ASCII  string.  It  may  not  contain  a 
pathname  since  it's  limited  to  8  characters.  For  this  reason,  the  FCB  functions  can 
access  only  files  in  the  current  directory.  Filenames  shorter  than  eight  characters 
are  padded  with  spaces  (ASCII  code  32).  The  file  extension,  if  any,  occupies  the 
next  three  bytes  of  the  FCB. 

At  offset  OCH  of  the  FCB  is  the  current  number  of  the  block  for  sequential  file 
access.  The  two  bytes  at  offset  OEH  are  the  record  size.  The  four  bytes  at  offset 
lOH  are  the  length  of  the  file. 

The  date  and  time  of  the  last  modifications  to  the  file  are  stored  beginning  at  offset 
14H  of  the  FCB  in  encoded  form. 
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15  14  13  12  11  10  9  87  65  4  3  2  1  0 


Hour  Minute  Seconds  in 


2-second 
increments  (e.g., 
13  means  26) 

15  14  13  12  11  10  9  8  7  6  5  4  3  2  1  0 


Year  (reiative  to  1 980)  Month  Day  of  month 


Format  of  time  and  date  stamps  in  the  FCB 

An  eight-byte  data  area  follows  and  is  reserved  for  DOS  (no  user  modifications 
allowed).  The  use  of  this  area  varies  from  one  version  of  DOS  to  another. 

Following  this  reserved  data  area  is  the  current  record  number  which  is  used  in 
connection  with  the  current  block  number  to  simulate  CP/M  operations. 

Random  files 

The  last  data  field  of  the  FCB  is  used  for  a  type  of  access  in  which  the  data  within 
the  file  may  be  retrieved  or  written  in  a  non-sequential  order.  This  field  is  four 
bytes  long.  If  a  record  is  equal  to  or  larger  than  64  bytes,  only  the  first  three  bytes 
are  used  for  indicating  the  current  record  number.  All  four  bytes  of  this  field  are 
used  for  records  smaller  than  64  bytes. 

Extended  FCB 

Besides  a  standard  FCB,  DOS  also  supports  the  extended  FCB.  Unlike  normal 
FCBs,  extended  FCBs  access  files  with  special  attributes,  such  as  hidden  files  or 
system  files.  Furthermore,  they  permit  access  to  volume  names  and  subdirectories 
(this  doesn't  mean  that  you  can  access  files  in  other  directories  besides  the  current 
directory). 

An  extended  FCB  is  similar  to  a  standard  FCB,  but  it's  seven  bytes  larger.  These 
seven  bytes  are  located  at  the  beginning  of  the  data  structure.  All  subsequent  fields 
are  therefore  displaced  by  seven  bytes. 
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+  OOH 

FF  (1  byte) 

+  OlH 

Reserved (0)  (5  bytes) 

+  06H 

File  attribute  (1  byte) 

+  07H 

Device  name  (1  byte) 

+  OSH 

Filename  (8  bytes) 

+  lOH 

File  extension  (3  bytes) 

+  13H 

Current  block  number  (1  word) 

+  15H 

File  record  size  (1  word) 

+  17H 

File  size  (2  words) 

+  IBH 

Modif ications-date  (1  word) 

+  IDH 

Modif ications-time  (1  word) 

+  IFH 

Reserved  (8  bytes) 

+  27H 

Current  data  record  number (1  byte) 

+  28H 

Data  record  number  (2  words) 

RAM 


0000:000(1 


▼ 


Structure  of  an  extended  FCB 

The  first  byte  of  an  extended  FCB  always  contains  the  value  255  and  identifies  this 
as  an  extended  FCB.  Since  this  address  contains  the  device  number  in  a  normal 
FCB  and  can  therefore  not  contain  the  value  255,  DOS  can  tell  the  difference 
between  a  normal  and  an  extended  FCB.  The  next  five  bytes  are  reserved 
exclusively  for  the  use  by  DOS.  They  should  not  be  changed.  The  seventh  byte  is 
a  file  attribute  byte.  See  Section  6.1.2  for  the  details  of  the  file  attribute  byte. 

Now  that  you're  familiar  with  the  FCB  structures,  the  next  section  focuses  on 
using  FCBs  for  accessing  files. 

FCB  and  file  access 

Before  accessing  a  file,  an  FCB  must  be  built  in  the  program's  memory  area.  The 
area  can  be  reserved  within  the  data  segment  of  the  program  or  by  allocating 
additional  memory  using  another  DOS  function  (see  Section  6.9). 

Although  it  is  possible  to  write  the  data  directly  into  the  FCB,  it  is  better  to  use 
one  of  the  appropriate  DOS  functions  to  do  this. 

For  example,  to  set  the  filename  in  the  FCB  you  can  use  DOS  function  29H.  The 
function  number  is  passed  in  the  AH  register.  The  address  of  the  FCB  is  passed  in 
the  ES:DI  register  pair.  The  address  of  the  filename  is  passed  in  the  DSrSI  register 
pair.  The  filename  is  an  ASCII  string  terminated  by  the  end  character  (ASCII  code 
0).  The  AL  register  contains  flags  for  converting  the  filename  and  are  discussed  in 
more  detail  in  Appendix  C. 

Open  FCB 

After  the  FCB  is  properly  formatted  the  file  can  be  opened  or  created  using  a  DOS 
function.  When  this  happens  DOS  stores  information  about  that  file  in  the  FCB 
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such  as  the  file  size,  date  and  time  of  file  creation,  etc.  At  this  point  the  FCB  is 
consid^*ed  opened. 

By  default,  the  record  length  is  set  to  128  bytes  when  the  FCB  is  opened.  To 
override  this  record  length,  store  the  desired  record  length  at  offset  OEH  of  the  FCB 
after  it  is  opened.  Otherwise  the  default  length  will  be  used. 


DTA 


For  record  lengths  greater  than  128  bytes,  the  record  buffer  also  known  as  the 
DTA,  or  Disk  Transfer  Area  must  be  moved  to  accommodate  the  longer  record 
size.  Normally,  DOS  builds  the  DTA  in  the  PSP  (Program  Segment  Prefix). 
Accessing  the  file  using  the  default  DTA  for  a  recOTd  length  greater  than  128  bytes 
would  overwrite  some  of  the  other  fields  in  the  PSP. 

The  most  convenient  way  to  select  a  new  DTA  is  to  reserve  the  space  in  the 
program's  data  segment.  To  change  the  address  of  the  DTA  use  DOS  function 
lAH.  The  address  of  the  new  DTA  is  passed  in  the  DS:DX  register  pair.  DOS 
assumes  that  you  have  set  aside  an  area  large  enough  to  accommodate  your  largest 
record  length  so  you  don't  have  to  specify  the  new  length. 

File  access 

For  sequential  file  access,  processing  begins  at  the  first  record  in  the  file.  DOS 
maintains  a  record  pointer  in  the  FCB  to  keep  track  of  the  current  record  within  the 
file.  Each  time  the  file  is  accessed,  DOS  advances  the  pointer  so  that  the  second, 
third,  fourth,  etc  record  is  processed  in  order. 

For  random  file  access,  the  records  can  be  processed  in  any  order.  The  position  of 
each  record  relative  to  the  beginning  of  the  file  determines  its  record  number.  This 
record  number  is  then  passed  to  DOS  to  access  a  specific  record.  The  last  field  of 
the  FCB  is  used  to  specify  the  record  number  to  DOS. 

It's  also  possible  to  change  from  sequential  access  mode  to  random  access  mode 
and  vice  versa  since  processing  depends  on  a  specific  DOS  function  to  access  the 
file.  In  effect,  there  are  two  sets  of  independent  functions,  one  for  sequential  access 
and  one  for  random  functions. 

Following  is  a  list  of  all  of  the  FCB  functions  of  DOS  interrupt  21H.  A  more 
detailed  description  of  the  functions  is  found  in  Appendix  C. 


Function  No. 

Task 

OFH 

Open  file 

lOH 

Close  file 

13H 

Delete  file 

14H 

Sequential  read 

15H 

Sequential  write 

16H 

Create  file 

17H 

Rename  file 
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Function  No. 

Task 

lAH 

Set  DTA  address 

21H 

Random  Read  (of  record) 

22H 

Random  Write  (of  record) 

23H 

Determine  file  size 

24H 

Set  record  number  for  random  access 

27H 

Random  read  (one  or  more  records) 

28H 

Random  write  (one  or  more  records) 

2  9H 

Enter  filename  into  FCB 

Some  basic  rules  about  these  functions  should  be  mentioned  here: 

Using  the  FCB  functions,  you  can  access  several  files,  each  with  their  own  unique 
FCB.  To  tell  DOS  which  file  is  to  be  accessed,  pass  the  address  of  the  file's  FCB 
in  the  DS:DX  register  pair. 

Most  of  the  functions  return  an  error  code  in  the  AL  register  or  the  value  zero  if 
the  function  was  successfully  completed.  For  functions  which  open,  close,  create 
or  delete  a  file,  a  code  of  255  is  returned  if  an  error  occurs.  The  other  functions 
return  specific  error  codes.  More  detailed  information  about  these  errors  can  be 
determined  by  calling  DOS  function  59H  but  is  available  only  in  versions  of  DOS 
V3.0  or  later. 

Handles  vs.  FCBs 

After  the  two  groups  of  functions  made  available  by  DOS  have  been  presented,  the 
advantages  and  disadvantages  of  the  individual  functions  should  be  discussed 
briefly.  For  those  who  want  to  convert  a  program  from  the  CP/M  or  UNIX 
operating  systems  into  DOS,  the  choice  will  be  easy,  but  for  those  who  want  to 
develop  a  new  program  under  DOS,  this  discussion  can  help  in  your  deciding  on 
which  set  of  functions  to  use. 

Handles 

There  are  two  main  advantages  to  using  handle  functions.  The  first  is  the 
capability  to  access  a  file  in  any  subdirectory  of  the  disk.  The  second  is  that  the 
handle  functions  are  not  limited  to  the  number  of  FCBs  which  can  be  stored  in  a 
program's  memory  space. 

There  are  a  number  of  additional  considerations.  You  can  access  the  name  of  a  disk 
drive  only  by  using  an  FCB.  When  the  FCB  is  opened,  you  can  easily  determine 
its  file  size  and  the  date  of  the  last  modification.  The  handle  functions 
automatically  provide  an  area  large  enough  to  accommodate  the  records  in  the  file. 

As  you  can  see  there  are  arguments  for  and  against  using  either  the  FCB  functions 
or  the  handle  functions.  For  future  versions  of  DOS,  the  handle  functions  will  play 
a  more  important  role  and  the  importance  of  the  FCB  functions  will  diminish. 
This  is  reason  enough  to  use  the  handle  functions  for  your  new  program 
development 
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6.7  Accessing  the  DOS  Directory 

There  are  two  groups  of  DOS  functions  for  working  with  directories.  The  first 
group  is  used  to  manipulate  the  subdirectories  and  the  second  to  search  for  files  on 
the  mass  storage  devices. 

With  DOS  Version  2.0  came  the  introduction  of  subdirectories.  A  mass  storage 
device  could  be  logically  divided  into  smaller  subdirectories  which  could  in  turn  be 
further  subdivided.  In  effect  this  organization  created  a  directory  tree. 


Main  directory 


Directory  tree 

In  this  directory  tree,  the  names  and  numbers  of  subdirectories  are  not  static. 
Therefore  there  must  be  a  way  to  add,  change  and  delete  entries  on  the  tree.  Other 
functions  must  be  available  to  set  the  current  directory  so  that  a  complete 
pathname  is  not  required  for  all  file  accesses. 

At  the  user  level  the  MD,  RD  and  CD  commands  can  be  used  to  make  a  directory, 
remove  a  directory  and  change  a  current  directory.  Internally,  these  commands  are 
performed  with  functions  39H,  3  AH  and  3BH  of  DOS  interrupt  21H. 

All  three  functions  use  identical  calling  conventions. 

The  function  number  is  passed  in  the  AH  register.  The  address  of  the  path  is  passed 
in  the  DS:DX  register  pair.  The  path  is  a  string  and  may  be  a  complete  path 
designation  including  a  preceding  drive  letter  followed  by  a  colon  (a  device  name) 
and  terminated  by  ASCII  code  0.  If  the  device  name  is  omitted,  the  current  device 
is  the  default. 
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Following  execution,  the  carry  flag  indicates  the  return  code.  If  the  carry  flag  is 
reset  (0),  then  execution  was  successful.  If  the  carry  flag  is  set,  then  an  error 
occurred  and  the  error  code  is  passed  back  in  the  AX  regist^. 

Function  39H  creates  or  makes  a  new  directory  (Make  DirecUMy).  The  name  fcM*  the 
new  directory  is  specified  as  the  last  element  in  the  path.  An  error  will  be  returned 
by  the  functions  if  one  or  more  of  the  directories  specified  in  the  path  do  not  exist, 
if  the  new  directory  name  already  exists  or  if  the  maximum  number  of  files  in  the 
root  directray  is  exceeded. 

Function  3  AH  deletes  or  removes  a  directory  (Remove  Directory).  An  error  will  be 
returned  by  the  function  if  the  target  directory  is  not  empty  or  the  specified 
directory  does  not  exist  in  the  current  path. 

Function  3BH  changes  the  current  directory  (Change  Directory).  An  error  is 
returned  if  the  directOTies  named  in  the  path  do  not  really  exist. 

Function  OEH  sets  the  default  disk  drive.  Besides  the  function  number  in  the  AH 
register,  only  the  device  code  of  the  new  current  device  must  be  passed  in  the  DL 
register.  Code  0  stands  for  the  device  A,  1  for  B,  2  for  C,  etc. 

Directory  specification 

Before  specifying  the  current  directory  using  function  3BH,  it  is  sometimes 
necessary  to  find  the  current  directory.  DOS  makes  function  47H  available  to  the 
programmer  for  this  purpose.  Since  it  can  return  the  path  of  the  current  directory 
for  any  device,  the  device  number  must  be  passed  to  the  function.  If  this  is  the 
current  device,  the  value  0  must  be  passed  in  the  DL  register.  For  all  other  devices, 
the  value  1  must  be  passed  for  drive  A,  2  for  B,  3  for  C,  etc. 

Besides  the  device  code,  the  function  must  also  have  the  address  of  a  64-byte  buffer 
within  the  user  program.  The  DS  register  contains  the  segment  and  the  SI  register 
holds  the  offset  address  of  this  buffer.  After  the  function  call  this  buffer  contains 
the  path  designation  of  the  current  directory,  terminated  with  the  end  character 
(ASCII  code  0).  The  path  designation  cannot  be  preceded  by  the  device  name  (x  the 
\  character.  If  the  current  directory  is  the  root  directory,  the  buffer  contains  only  the 
end  character.  If  a  device  code  unknown  to  DOS  was  passed  during  the  function 
call,  the  carry  flag  is  set  and  the  AX  register  contains  the  error  code  OFH. 

Let's  consider  the  functions  for  searching  for  one  or  more  files  in  the  current 
directory  on  the  current  device.  Again  the  parallel  between  handle  and  FCB 
functions  appears.  Two  function  groups  exist  to  search  for  files.  The  group  of 
FCB  functions  has  the  disadvantage  that  they  limit  the  search  to  files  in  the  current 
directory  of  a  certain  device,  while  handle  functions  allow  searching  for  files  in  any 
directories  of  any  devices.  The  term  "handle"  functions  doesn't  really  fit  these 
functions  since  they  are  not  addressed  with  a  handle.  This  designation  originated 
with  the  introduction  of  subdirectories  (and  therefore  the  handle  functions)  in  DOS 
Version  2.0.  Version  1.0  offered  only  the  FCB  functions. 
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6.7.1  Searching  for  Files  using  FCB  Functions 

This  method  of  file  search  uses  functions  IIH  and  12H.  Using  them  you  can 
search  for  files  with  a  fixed  name  or  files  with  a  filename  extension.  Function  1 IH 
finds  the  first  file  in  the  current  directory.  Function  12H  finds  all  other  additional 
files.  The  FCBs  play  a  significant  role  since  they  mediate  between  the  calling 
program  and  the  two  functions.  Let’s  see  how  we  can  search  for  files  in  a  directory: 

First  the  program  must  reserve  space  for  two  FCBs.  This  is  done  either  by 
reserving  memory  in  the  data  area  of  the  program,  or  by  requesting  memory  from 
DOS  using  function  48H.  The  programmer  can  use  either  normal  or  extended 
FCBs.  Extended  FCBs  offer  the  advantage  of  being  able  to  search  for  files  with 
special  attributes  (system  or  hidden),  volume  names  and  subdirectories.  The 
filename  for  which  the  search  will  be  made  is  specified  in  one  of  the  FCBs.  DOS 
places  the  name  of  the  file(s)  that  it  finds  in  the  other  FCB.  To  differentiate 
between  the  two  FCBs,  they  are  designated  with  the  names  Search  FCB  and  Found 
FCB. 

The  address  of  the  Found  FCB  must  be  passed  to  DOS  using  function  lAH.  The 
Found  FCB  becomes  the  new  data  transmission  area  (DTA)  when  this  function  call 
occurs.  This  area  is  important  for  these  two  functions  as  well  as  all  other  functions 
which  transfer  data  between  computer  and  disks.  For  this  reason  function  2FH 
should  determine  the  address  of  the  current  DTA  before  activating  the  new  DTA. 
When  the  file  search  ends,  the  DTA  can  be  restored  to  its  original  state  using 
function  lAH. 

After  the  DTA  is  set  to  the  Found  FCB,  the  next  step  is  to  place  the  name  of  the 
file  you  are  looking  for  into  the  Search  FCB.  For  a  more  general  search,  the 
wildcards  *  and  ?  may  be  used.  You  can  transfer  the  filename  directly  or  transfer  it 
using  function  29H.  If  you  want  to  search  through  all  files,  use  the  filename  ♦.*. 
If  an  extended  FCB  is  used,  you  may  insert  an  additional  value  into  the  attribute 
field  of  the  Search  FCB  to  limit  the  search  to  files  with  certain  attributes  only  (see 
Section  6.12  for  more  information  on  the  various  attributes). 

This  concludes  the  preliminary  work.  The  file  search  can  begin  with  the  current 
directory.  For  this  purpose,  function  IIH  is  called  with  the  function  number  in  the 
AH  register,  the  segment  address  of  the  Search  FCB  in  DS  and  the  offset  address  in 
the  DX  register.  If  the  system  finds  a  file  with  the  indicated  name,  the  AL  register 
contains  the  value  0  after  the  function  call.  If  the  filename  wasn’t  found,  the  AL 
register  contains  a  value  of  255.  The  found  filename  and  its  attributes  (if  extended 
FCBs  are  used)  can  be  read  from  the  Found  FCB.  For  additional  searches,  function 
12H  (not  function  IIH)  is  called.  Function  12H's  register  contents  during  call  and 
return  are  similar  to  function  IIH.  If  it  returns  the  value  255  in  the  AL  register 
during  one  of  the  calls,  the  search  has  ended. 
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6.7.2  Searching  for  Flies  using  Handle  Functions 

Working  with  handle  functions  is  easier  than  working  with  the  FCB  functions. 
There  are  functions  for  searching  for  the  first  file  (the  4EH  function)  and 
subsequent  files  (the  4FH  function).  Both  functions  return  the  information  to  the 
DTA.  For  this  reason  the  DTA  should  be  moved  into  an  area  accessible  to  the 
current  program  before  calling  either  of  these  functions.  This  area  must  have  at 
least  43  bytes  available.  As  mentioned  in  connection  with  the  FCB  functions,  the 
DTA  should  be  rest(»^  to  its  original  address  after  the  search  ends. 

During  the  call  of  the  4EH  function,  the  function  number  is  passed  in  the  AH 
register,  the  attribute  in  the  CX  register  and  the  address  of  the  file  to  be  found  in 
the  DS:DX  register  pair.  The  filename  is  a  series  of  ASCII  characters,  terminated 
with  an  end  character  (ASCII  code  0).  In  addition  to  a  device  name,  you  may  add  a 
complete  path  designation  and  the  wildcard  characters  *  and  ?.  If  a  path  is  not 
specified,  DOS  assumes  that  the  search  should  be  made  in  the  current  Rectory  of 
the  indicated  device.  If  a  device  is  not  specified,  the  search  proceeds  on  the  current 
device.  After  the  function  call,  the  carry  flag  indicates  whether  a  file  was  found.  If 
the  file  couldn't  be  found,  the  carry  flag  is  set,  and  the  AX  register  contains  an 
error  code.  An  errcM*  code  of  2H  is  returned  if  the  indicated  path  does  not  exist  If  no 
file  could  be  found,  an  error  code  of  12H  is  returned.  If  the  carry  flag  is  reset,  the 
DTA  contains  the  information  about  the  file  found.  It  has  the  following  structure: 


Address 

Contents 

Type 

+00H 

reserved  for  DOS 

21  bytes 

+15H 

Attribute  of  file  found 

1  byte 

+16H 

Time  of  last  modification 

1  word 

+18H 

Date  of  last  modification 

1  word 

+1AH 

low  word  of  file  size 

1  word 

+1EH 

high  word  of  file  size 

Function  4FH  executes  any  further  searches.  The  function  number  is  passed  in  the 
AH  register,  and  no  other  parameters  are  required.  The  carry  flag  indicates  if  there 
are  additional  flies  in  the  current  directory  to  which  the  search  may  be  applicable. 
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Demonstration  programs 

The  three  programs  below  read  directory  entries  and  display  them  on  the  screen 
using  one  of  the  handle  functions.  You’ll  find  the  display  more  user  friendly  than 
the  DOS  DIR  command:  the  files  appear  in  a  window,  and  the  filename  display 
stops  as  soon  as  the  window  is  filled  with  filenames.  This  permits  easy  reading  of 
filenames.  By  pressing  any  key,  the  program  displays  any  additional  pages  of 
filenames. 


All  three  programs  are  designed  on  the  same  basic  principle:  first  the  main 
program  determines  the  search  path.  It  contains  the  names  of  the  directories  in 
which  the  search  should  be  made  for  the  files,  the  names  of  the  files  and  the  device 
where  the  directory  is  located.  This  name  can  contain  wildcards  (*  and  ?)  to  search 
for  several  files  at  the  same  time.  If  the  user  does  not  indicate  a  search  path,  the 
program  defaults  to  the  search  path  This  displays  all  files  in  the  current 
directly  of  the  current  device,  as  well  as  the  hidden  attribute  files. 

After  the  program  determines  the  search  path,  a  routine  coordinates  the  loading  and 
display  of  individual  directory  entries.  First  a  routine  creates  the  display  window  on 
the  screen  for  individual  entry  output.  Then  a  search  proceeds  for  the  first  entry 
using  DOS  function  4EH.  If  an  entry  is  found,  the  screen  displays  the  entry. 
Function  4FH  searches  for  all  subsequent  entries  and  displays  them  in  the  window. 


The  bottom  line  of  the  display  window  moves  up  one  line  with  each  new  line 
displayed.  Once  the  entire  window  fills  with  data,  any  further  display  of  entries 
stops  until  the  user  presses  a  key.  After  all  entries  in  the  selected  directory  have 
been  displayed,  the  number  of  files  is  displayed  and  the  program  ends. 

BASIC  listing:  DIRB.BAS 

100  '*****************************************************************• 

110  •*  D  I  R  B  *' 

120  •* - *• 

130  '*  Task  :  display  all  files  in  a  directory  *' 

140  **  in  a  window  on  the  display  *' 

160  •*  Author  :  MICHAEL  TISCHER  *' 

170  '*  developed  :  07/23/87  *' 

180  •*  last  Update  :  04/08/89  *• 

190  '*****************************************************************• 

200  • 

210  CLS  :  KEY  OFF 

220  PRINT "WARNING:  This  program  can  be  run  only  if  GWBASIC  was  started" 

225  PRINT"  from  the  " 

230  PRINT"DOS  level  with  the  <GWBASIC  /m:60000>  command."  :  PRINT 
240  PRINT"If  this  is  not  the  case,  please  enter  <s>  for  Stop." 

250  PRINT  :  PRINT"Otherwise  press  any  key  ..."; 

260  A$  =  INKEY$  :  IF  A$  =  "s"  THEN  END 
270  IF  A$  =  ""  THEN  260 

280  GOSUB  60000  'Install  function  for  calling  interrupt 

290  CLS 

300  PRINT  "DIR  (c)  1987  by  Michael  Tischer" 

310  PRINT 

320  PRINT"Please  input  the  search  path  for  the  file." 

330  PRINT "Exaitple:  If  all  files  with  the  extension  .BAT  in  the  Root" 

340  PRINT"  directory  of  the  disk  in  drive  A  should  be  displayed, " 

350  PRINT"  then  please  input  A:\*.BAT." 

360  PRINT"Wlth  a  blank  input,  all  files  in  the  current  directory  " 
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'  Input  Search  Path 
•search  in  current  directory 
•14  Display  entries  in  window 
•Input  Directory  and  output 


370  PRINT-are  displayed.-  :  PRINT 
380  INPUT  -Search  Path:  -,DIR$ 

390  IF  DIRS  «  --  THEN  DIRS  - 
400  ENTRY%  -  14 
410  GOSUB  50000 
420  END 
430  • 

50000  '*★**★★**★★**★★★★★★★*★*★★*★*★*★★★*★★*★*★**★★***★★***************• 
50010  •*  Input  one  Directory  and  display  *' 

50020  •* - *• 

50030 
50040 
50050 
50060 
50070 
50080 
50090 
50100 
50110 
50120 
50130 
50140 
50150 
50160 
50170 
50180 

50190 
50200 
50210 
50220 
50230 
50240 


•*  Input:  DIRS  *  the  search  path  *' 

•*  ENTRY%  *  Number  of  entries  in  the  window  *' 

•  *  Output :  none  * ' 

***************************************************************** 

DIM  MONTHS [11]  'accepts  names  of  months 

RESTORE  50600 

FOR  1%  «  0  TO  11  :  READ  MONTHS [I%]  :  NEXT 

INR%  =  &H21  'Call  DOS-Interrupt  21H 

FCT%  =  &H2F  'Get  function  number  for  DTA 

CALL  lA (INR%, FCT%, Z%, OFSHI%, OFSLO%, Z%,  Z%, Z%,  Z%,  Z%, Z%, DTASEG%, Z%) 
DTAOFS%  =  OFSLO%  +  OFSHI%  *  256 
CLS 

OFFSET%  =  INT((20  -  ENTRY%)  /  2)  +  1  'Start  line  of  window 

LOCATE  OFFSET%,14 

PRINT  TAB(14)"r - T - T - T - T - ^1" 


T - T - 

PRINT  TAB(14)-|  Filename  |  Size  |  Date 
PRINT  TAB  (14)"  I- 


-T - 

I  Time  |RHSVD|' 

-H - 1- - r 


FOR  1%  =  1  TO  ENTRY% 
PRINT  TAB (14) "I 
NEXT 

PRINT  TAB(14)"L - 


•output  a  line  for  every  entry 

II  I  11“ 

•output  next  line 

_1 - -1 - 1 - ^1 - 


50250 

50260 

50270 

50280 

50290 

50300 

50310 

50320 

50330 

50340 

50350 

50360 

50370 

50380 

50390 

50400 

50410 

50420 

50430 

50440 

50450 

50460 

50470 

50480 

50490 

50500 

50510 

50520 

50530 

50540 

50550 

50560 

50570 

50580 

50590 

50600 

50610 


NUMWIND%  =  -1 
NUMFND%  =  0 
ATTRIBUTE%  =255 
GOSUB  51000 

IF  NOT (F0UNDIT%)  THEN  50500 
NUMFND%  =  NUMFND%  +  1 
NUMWIND%  =  NUMWIND%  +  1 
IF  NUMWIND%  <>  ENTRY%  THEN  50410 
LOCATE  OFFSET%+ENTRY%+4, 14 


•Number  of  entries  in  window 
•Number  of  entries  found  up  to  now 
•search  for  files  with  any  Attribute 
•search  for  first  entry 
•no  entry  found  — >  finished 
' Increase  number  of  entries  found 
'Increase  number  of  entries  in  window 
•window  full? 
Set  Cursor  to  line  under  window 


•switch  on  inverse  character  display 
Please  press  any  key 

""  THEN  50360  'wait  for  a  key 

•Cursor  in  line  under  window 
•switch  on  normal  character  color 


COLOR  0,7 
PRINT" 

AS  =  INKEYS  :  IF  AS- 
LOCATE  ,14 
COLOR  7,0 
PRINT  STRINGS (51,"  "); 

NUMWIND%  =  -1  'the  next  entry  is  the  first  in  the  window 

NUMBER%  =  1  :  COLOUR%  =  7 

ULR%  =  0FFSET%  +  2  :  LRR%  =  OFFSET%+ENTRY%  +  1 
ULC%  =  14  :  LRC%  =  62 

•scroll  window  up 
•Set  Cursor  to  last  window  line 
I  I 

•Output  entry 
•Get  next  entry 
•continue  if  no  entry  is  available 
•Cursor  in  line  under  the  window 
•switch  on  inverse  character  display 


I 


GOSUB  54000 

LOCATE  OFFSET%+ENTRY%+2, 15 
PRINT  -  I 

GOSUB  53000 
GOSUB  52000 
IF  FOUNDIT%  THEN  50300 
LOCATE  OFFSET%+ENTRY%+4,14 
COLOR  0,7 
PRINT  STRINGS (51,"  "); 

LOCATE  ,14  'Cursor  in  line  under  window 

IF  NUMFND%  =  0  THEN  PRINT"  no  file  found";  :  GOTO  50570 
IF  NUMFND%  =  1  THEN  PRINT"  found  one  file";  :  GOTO  50570 
PRINT  NUMFND%; "files  found"; 

COLOR  7,0  'switch  on  normal  character  color 

RETURN 


DATA  "JAN", "FEB", "MAR", -APR-, "MAY", -JUN", -JUL", -AUG", "SEP" 
DATA  -OCT", "NOV", "DEC" 
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50620 

51000 

51010 

51020 

51030 

51040 

51050 

51060 

51070 

51080 

51090 

51100 

51110 

51120 

51130 

51140 

51150 

51160 

51170 

51180 

51190 

51200 

51210 

52000 

52010 

52020 

52030 

52040 

52050 

52060 

52070 

52080 

52090 

52100 

52110 

52120 

52130 

52140 

52150 

52160 

53000 

53010 

53020 

53030 

53040 

53050 

53060 

53070 

53080 

53090 

53100 

53110 

53120 

53130 

53140 

53150 

53160 

53170 

53180 

53190 

53200 

53210 

53220 

53230 

53240 

53250 

53260 

53270 

53280 


*★★★★★★★★★★★★★★*★************************************★*******★★• 

*  Search  for  first  entry  in  a  Directory  *' 

*  Input:  DIR$  »  Search  path  *' 

*  ATTRIBUTE%  -  Attribute  of  file  *' 

*  Output:  FOUND_IT%  -  -1  if  entry  found,  otherwise  0  *' 

*  Info  :  the  Directory  entry  is  entered  into  Variable  DTA% 

*  *  • 

*  Z%  is  a  Dummy-Variable  *' 


DIRS  =  DIRS  +  CHRS(O)  'Put  End  character  on  search  path 

FCT%  =  &H4E  'Search  function  number  for  first  entry 

INR%  =  &H21  'Call  DOS-Interrupt  21H 

ATLO%  -  ATTRIBUTE%  AND  255  'LO-Byte  of  Attribute 

ATHI%  -  INT (ATTRIBUTE%  /  256)  'HI-Byte  of  Attribute 

OFSLO%  =  PEEK (VARPTR (DIRS) +1)  'LO-Byte  of  Offset  address 

OFSHI%  »  PEEK (VARPTR (DIRS) +2)  'HI-Byte  of  Offset  address 

CALL  lA (INR%, FCT%, Z%, Z%,  Z%, ATHI%, ATLO%, OFSHI%, OFSLO%, Z%, Z%, Z%, FLAGS%) 
FOUNDIT%  »  ((FLAGS%  AND  1)  =  0)  'Test  Carry-Flag 

RETURN  'return  to  calling  program 

***************************************************************** 

'*  find  next  entry  in  Directory  *' 

•  * - *  • 

'*  Input  :  DIRS  =  Search  path  *' 

'*  ATTRIBUTE%  =  Attribute  of  file  *' 

'*  Output:  FOUNDIT%  =  -1  if  file  found,  otherwise  0  *' 

'*  Info  :  the  Directory  entry  is  read  into  Variable  DTA%  *' 


'*  Z%  is  a  Dummy-Variable  *' 

•  *****-k-k*it*****ifk**-k****it******it***ii**ifk******it****************** 


FCT%  =  &H4F  'Find  function  number  for  next  entry 

INR%  =  &H21  'Call  DOS-Interrupt  21H 

CALL  lA (INR%, FCT%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, FLAGS%) 

FOUNDIT%  =  ((FLAGS%  AND  1)  =  0)  'test  Carry-Flag 

RETURN  'back  to  calling  program 


'*  Output  a  Directory  entry  from  the  DTA  to  the  display  *' 


'*  Input:  OFFSET%  =  first  line  of  the  Directory  window  *' 

'*  ENTRY%  =  Number  of  entries  in  the  Directory  window  *' 

'*  DTAOFS%  =  Offset  address  of  the  DTA  *' 

'*  MONTHS  =  contains  the  names  of  months  *' 

'*  Output:  none  *' 

•*it  ***■*[  it-k  **************** -k-k-k-kitititifkifkitititltlclcififk  ******  ************** 


DEF  FNDTA(X)  =  PEEK(DTAOFS%  +  X) 

DEF  SEG  =  DTASEG%  'Set  Segment  address  of  the  DTA 
LOCATE  OFFSET%+ENTRY%+2, 15  'Output  in  the  last  line  of  the  window 
1%  =  30  'Offset  address  in  DTA  for  file  names 
WHILE  FNDTA(I%)  <>  0  'the  END  character  terminates  the  name 
PRINT  CHRS (FNDTA (1%) ) ;  'output  a  character  of  the  file  name 
1%  =  1%  +  1  'next  character 
WEND  'End  of  Loop 
LOCATE  OFFSET%+ENTRY%+2,  28  'Set  Cursor  to  column  28 
PRINT  USING  "#######";  FNDTA  (26)  +  FNDTA (27)  *  256!  +  FNDTA (28)  * 
4096!  +  FNDTA (29)  *  65536!; 

DATE  =  FNDTA (24)  +  FNDTA (25)  *  256  'Get  Date 
LOCATE  OFFSET%+ENTRY%+2,36  'Set  Cursor  to  Column  36 
PRINT  MONTHS [ (INT (DATE  /  32)  AND  15)  -  1];  'Output  name  of  month 
PRINT"/"; : PRINT  USING  "##";DATE  AND  31;  'Output  day  of  month 
PRINT  USING  "/####"; INT (DATE  /  512)  +  1980;  'Output  year 
LOCATE  OFFSET%+ENTRY%+2,49  'Set  Cursor  to  column  49 
FTIME  =  FNDTA (22)  +  FNDTA (23)  *  256  'Get  time 
PRINT  USING  "##"; INT (FTIME  /  2048);  'Output  hour 
PRINT 
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53290 

53300 

53310 

53320 

53330 

53340 

53350 

54000 

54010 

54020 

54030 

54040 

54050 

54060 

54070 

54080 

54090 

54100 

54110 

54120 

54130 

54140 

54150 

54160 

54170 

54180 

54190 

60000 

60010 

60020 

60030 

60040 

60050 

60060 

60070 

60080 

60090 

60100 

60110 

60120 

60130 

60140 

60150 

60160 

60170 

60180 

60190 

60200 

60210 

60220 

60230 


PRINT  USING  "ff-zINKrTIME  /  32)  AND  63;  'Output  Minute 
LOCATE  OFFSET%+ENTRY%+2,59  'Set  Cursor  to  column  59 
FOR  1%  -  0  TO  4  'test  Bits  0  to  4  of  file  attribute 
IF  (FNDTA(21)  AND  (2^1%))  <>  0  THEN  PRINT-X";  ELSE  PRINT" 

NEXT  1%  'test  next  Bit 
DEF  SEG  :  RETURN  'back  to  calling  program 


I  ****** *********************************************************** 

'*  Scroll  current  display  page  up  or  erase 


'*  Input  :  NUMBER%  »  how  many  lines  scrolled 
'*  ULC%  »  column  upper  left 

'*  ULR%  *  line  upper  left 

'*  LRC%  “  column  lower  right 

'*  LRR%  =  line  lower  right 

'*  COLOR%  =  color  of  erased  line 

' *  Output :  none 

•*  Info  :  If  0  is  given  for  NUMBER%,  the  screen  area 
'*  indicated  is  erased 


*  i 


'*  the  Variable  Z%  is  a  Dummy  *' 

***************************************************************** 


FCT%=6  'Function  number  for  scrolling  up 

INR%=iH10  'Call  BlOS-Video-Interrupt  16H 

CALL  lA (INR%, FCT%, NUMBER%, COLOUR%, Z%, ULR%, ULC%, LRR%, LRC%, Z%, Z%, Z%, Z%) 
RETURN  'back  to  calling  program 

***************************************************************** 

'*  Initialize  Routine  for  Interrupt  call  *' 

I  * _ _ _ _ _ _ _ _ _ • 

'*  Input  :  none  *' 

'*  Output:  lA  is  the  Start  address  of  the  Interrupt -Routine  *' 

I  ***************************************************************  I 


IA»=60000!  'Start  address  of  the  Routine  in  the  BASIC-Segment 

DEF  SEG  'Set  BASIC-Segment 

RESTORE  60130 

FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'Poke  Routine 
RETURN  'back  to  calling  program 

DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 

DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 

DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 


One  problem  in  the  BASIC  version  of  the  directory  listing  occurs  during  the 
directory  output.  Functions  4EH  and  4FH  read  the  entry  into  the  DTA.  It  would 
make  more  sense  to  move  the  DTA  to  a  variable  within  the  program  (an  integer 
array  would  be  best)  to  make  it  easier  for  the  routine  which  outputs  the  entry  to 
access  the  data.  BASIC's  garbage  collection  feature  makes  this  difficult.  The 
integer  array  containing  the  DTA  moves  periodically  in  storage  and  the  address  of 
the  DTA,  stored  internally  in  DOS,  no  longer  corresponds  with  the  address  of  this 
integer  array. 

For  this  reason,  the  DOS  function  2FH  determines  the  DTA  address.  As  the  entries 
are  displayed,  this  address  accesses  the  DTA  to  determine  the  file  information. 
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Pascal  listing:  DIRP.PAS 

^ ****** ********* ************************************ *******************j 


{*  D  I  R  P  *} 

(* - *} 

{*  Task  :  Display  all  files  of  any  Directory,  *1 

{*  including  Subdirectories  and  *} 

{*  Volume  Names  *} 

^* - *} 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  on  :  7,8.87  *} 

{*  last  Update  :  9.21.87  *} 


^*********************************************************************1 
program  DIRP; 


Uses  {Turbo  4.0  Units} 

Crt, 

Dos; 

const  ENTRY  =14;  {  Number  of  entries  visible  } 


type  RegTyp  =  record 

ax,  bx,  cx,  dx,  bp, 

di,  si,  ds,  es,  flags  :  integer; 

{!  Turbo  4.0  owners  should  use  the  Registers  type  from  the  DOS  unit.} 
end; 


{**  this  is  the  format  of  a  Directory  entry  *★***} 
{**  as  returned  by  the  functions  4EH  and  4FH  } 
DirBufTyp  =  record 


Reservebuf 
Attribut 
Ztime 
Zdate 
Datgrlo 
Datgrhi 
Da t Name 
end; 


array  [1..21]  of  char; 
byte; 

Integer; 

integer; 

integer; 

integer; 

array  [1..13]  of  char 


Path  =  string [65]; 


var  DirBuf  :  DirBufTyp; 
DatName  :  Path; 


{  accepts  a  Directory  entry  } 
{  Files  to  be  found  } 


^*********************************************************************j 


{*  GETFIRST:  read  in  the  first  Directory  entry  *} 
{*  Input  :  none  *} 
{*  Output  :  true  or  false,  depending  if  an  entry  was  found  *} 
{*  *} 
{*  Info  :  the  entry  is  stored  in  Variable  DIRBUF  *] 


^ ********************************************************************* j 


function  GetFirst (DateiName  :  Path;  {  files  to  be  found  } 

Attribute  :  integer)  :  boolean;  {  search  Attribute  } 


var  Register  :  regtyp;  {  Register-Variable  for  call  of  Interrupt  } 


begin 

DateiName  :=  DateiName  +  #0;  {  terminate  filename  with  NUL  } 

Register. ax  :=  $4E  shl  8;  {  Function  number  for  search  of  first  } 

Register. cx  :=  Attribute;  {  Attribute,  for  which  search  is  performed  } 
Register. ds  :=  seg (DateiName) ;  {  Segment  address  of  filename  } 

Register. dx  :=  succ (ofs (DateiName) ) ;  {  Offset  address  of  filename  } 

msdos (Dos. Registers (Register) ); {  Call  DOS  Interrupt  21H  (Turbo  4.0)} 

{NOTEtTurbo  3.0  users  should  change  previous  line  to  read  msdos (Register) ; } 

{  defined  in  DOS  unit.} 
if  (Register. flags  and  1)  =  0  {  Test  Carry-Flag  } 
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then  Get First  :=  true  {  Equal  to  0  :  file  found  } 

else  Get First  :=  false;  {  no  file  found  } 

end; 


{*  GETNEXT  :  read  in  the  following  Directory  entry  *} 
{*  Input  :  none  *} 
{*  Output  :  true  or  false,  depending  if  another  entry  was  found  *} 
{*  *} 
{*  Info  :  this  function  can  only  be  called  after  a  successful  *} 
{*  call  of  the  function  GETFIRST  *} 
{*  the  entry  is  stored  in  the  Variable  DIRBUF  *} 


^ **★***★★★★*★★★*★★★★★★***★★*★★★*★★**★**★★**★*★** ★*★★*★★**★**********★} 


function  GetNext  :  boolean; 

var  Register  :  regtyp;  {  Register-Variable  for  interrupt  call  } 


begin 

Register. ax  :«  $4F  shl  8;  { 

msdos (Dos. Registers (Register) ) ; 

{NOTE:  Turbo  3.0 

if  (Register. flags  and  1)  =  0 
then  GetNext  :=  true 
else  GetNext  false; 

end; 


Function  number  for  next  search  } 
{  Call  DOS  Interrupt  21H  V  4.0} 
users  should  change  the  previous) 
{line  to  read  msdos (Register) ; } 
{  Test  Carry-Flag  } 
{  Equal  to  0  :  File  found  } 
{  otherwise  no  file  found  } 


{*  PRINTDATA:  Output  information  on  an  entry  *} 
{*  Input  :  none  *} 
{*  Output  :  none  ♦} 
{*  Info  :  the  information  a)x)ut  the  entry  are  taken  by  this  *} 
{*  procedures  from  Variable  DIRBUF  *} 


^ ***************************************************************** 


procedure  Print Data; 
var  Counter  :  byte; 

DataLenghtl,  {  both  Variables  are  used  } 

DataLenght2  :  real;  {  to  calculate  file  length  } 

begin 

writeln;  {  the  window  is  scrolled  up  by  one  line  } 

Counter  :=  1;  {  begins  with  the  first  character  of  the  name  } 

while  (DirBuf.DatName [Counter] <>#0)  do  {  repeat  up  to  NUL  } 

begin 

write (DirBuf.DatName [Counter] ) ;  {  output  characters  of  name  } 

Counter  :=  succ (Counter)  {  process  next  character  } 

end; 

gotoxy(13,  ENTRY); 

DataLenghtl  :=  DirBuf .Datgrhi;  {  determine  file  length  } 

if  DataLenghtl  <  0  then  DataLenghtl  :=  65536.0  +  DataLenghtl; 
DataLenght2  :=  DirBuf .Datgrlo; 

if  DataLenght2  <  0  then  DataLenght2  :*  65536.0  +  DataLenght2; 
writeCr,  DataLenghtl  *  65536.0  +  DataLenght2:7:0); 
gotoxy(21,  ENTRY); 
write  Cl'); 

case  (DirBuf. Zdate  shr  5  and  15)  of  {  determine  month  } 


1 

write  ('Jan') 

2 

write  ('Feb') 

3 

write  ('Mar') 

4 

write  ('Apr') 

5 

write  ('May') 

6 

write  ('Jun') 

7 

write  ('Jul') 

8 

write  ('Aug') 

9 

write  ('Sep') 

10 

write  ('Oct') 

11 

write  ('Nov') 

12 

write  ('Dec') 
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{  determine  day  } 
{  determine  year  } 


end; 

write  ('/',DirBuf.Zdate  and  31:2,'/'}; 
write (DirBuf.Zdate  shr  9  +  1980:4); 
gotoxy(34,  ENTRY); 

writeCr,  DirBuf.Ztime  shr  11:2,  ':');  {  determine  hour  } 

write (DirBuf.Ztime  shr  5  and  63:3);  {  determine  minutes  } 

gotoxy(44,  ENTRY);  {  evaluate  file  attribute  } 

write  Cl');  {  separator  to  preceding  field  } 


{  Read-only?  } 


if  (DirBuf  .Attribut  and  1)00  then  write  ('X' 

else  write ('  ' 

if  (DirBuf  .Attribut  and  2)o0  then  write  ('X' 

else  write ('  ' 

if  (DirBuf  .Attribut  and  4)00  then  write  ('X' 

else  write (' 

if  (DirBuf  .Attribut  and  8)00  then  write  ('X' 

else  write ( ' 

if  (DirBuf .Attribut  and  16)  OO  then  write  ('X') 

else  write ( '  ' ) ; 

write  cJ');  {  right  border  of  window  frame  } 

end; 


{  hidden?  ) 
{  system?  } 
{  Volume-Label?  } 
{  Directory?  } 


I ****************************************** ★*★★★******★★**★****★*★****1 

(*  SETDTA  :  set  Address  of  DTA  *} 

{*  Input  :  see  above  *) 

{*  Output  :  none  *} 

I ***********************.*  *************** *★***★★* ********* ★************) 

procedure  SetDTA (Segment,  {  new  Segment  address  of  the  DTA  } 

Offset  :  integer);  {  new  Offset  address  of  the  DTA  } 

var  Register  :  regtyp;  (  Register-Variable  for  call  of  the  Interrupt  } 

begin 

Register. ax  :=  $1A  shl  8;  {  Set  Function  number  for  DTA  } 

Register. ds  :=  Segment;  {  Segment  address  into  DS  register  } 

Register. dx  :=  Offset;  {  Offset  address  into  DX  register  } 

msdos (Dos. Registers (Register) ) ;  {  Call  DOS-Interrupt  21H  } 

(NOTE:  Turbo  3.0  users  should  change  the  previous} 
(line  to  read  msdos (Register) ; } 

end; 


^*********************************************************************1 


{*  BUI LDSCREENDI SPLAY:  prepares  the  display  for  output  of  the  *} 
(*  Directory  *} 
{*  Input  :  none  *) 
(*  Output  :  none  *} 


^ *********************************************************** **********} 


procedure  Bui IdScreenDi splay; 
var  Counter  :  integer; 
begin 

clrscr;  (  clear  display  } 

window (14, (20-ENTRY)  shr  1+1, 64,  (20-ENTRY)  shr  1  +5+ENTRY) ; 
gotoxy(l,l);  {  Cursor  to  left  upper  corner  of  window  } 

write  cf - T - T - : - T - T - 

write  Cl  Filename  |  Size  |  Date  |  Time  |RHSVD|'); 

write  ( '  I - + - 1- - H - H - 1  ' )  ; 

for  Counter  :=  1  to  ENTRY  do 

write  Cl  |  |  |  I  I  ' )  ; 

write  ( 'L - 1 - 1 - 1 - 1 - ^J' ) ; 

window (15, (20-ENTRY)  shr  1+4, 66,  (20-ENTRY)  shr  1  +3+ENTRY) ; 
gotoxy(l,  ENTRY);  {  Cursor  to  up^>er  left  corner  of  window  } 

end; 

^ ****************************************** ***************************} 
{*  DIR:  controls  the  input  and  output  of  Directories  *} 

(*  Input  :  none  *} 
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{*  Output  :  none  *} 

^ ***★*★*★★*★**** ********************* ********** ************* *★*★****★*} 

procedure  Dir; 

var  NumEntries,  {  Total  number  of  entries  found  } 

Numwind  :  integer;  {  Number  of  entries  in  window  } 

Keypress  :  char;  {  wait  for  key  activation  } 

begin 

SetDTA(Seg(DirBuf) ,  Ofs (DirBuf ) > ;  {  DirBuf  is  the  new  DTA  } 

clrscr;  {  clear  display  } 

writelnCDIR  (c)  1987  by  Michael  Tischer •  #13#10)  ; 
writeln( 'Please  indicate  search  path  for  files  '); 

writelnCExairple:  if  all  files  with  the  extension  .BAT  in  the  root  '); 
writelnC directory  of  the  disk  drive  should  be  displayed  please  input  '); 
writelnC  A:*.BAT.'); 

writelnC  If  no  search  path  is  indicated,  all  files  in  the  current'); 
writelnC  directory  are  displayed. '#13#10)  ; 


write ('Which  files  are  to  be  displayed: 

readln (DatName) ; 

if  DatName  =  ''  then  DatName  := 


■); 


{  read  in  filenames  } 
{  search  for  all  files  } 


Bui IdScreenDisplay ; 

Numwind  :=  -1; 

NumEntries  :*  0; 

if  GetFirst (DatName,  255)  then 

repeat 

NumEntries  :=  succ (NumEntries) ; 
Numwind  :=  succ (Numwind) ; 
if  Numwind  =  ENTRY  then 
begin 


{  Construct  display  for  output  } 
{  no  entry  in  window  yet  } 
{  no  entry  found  } 
{  search  for  first  entry  } 
{  Attribute  does  not  matter  } 

{  found  another  entry  } 
{  one  more  entry  into  window  } 
{  window  full  ?  } 
(  Yes  ) 


window (14,  (20-ENTRY)  shr  1  +5+ENTRY, 66, (20-ENTRY)  shr  1  +6+ENTRY); 
gotoxy(l,  1);  {  Cursor  to  last  line  of  window  } 


{  white  background  } 
{  black  characters) 
•); 

{  wait  for  key  press  } 
{  read  key  code  } 


text background (7) ; 
textcolor (0) ; 

write ('  Please  press  a  key 

repeat  until  keypressed; 

{read(kbd,  KeyPress);} 

{  otherwise  it  remains  in  the  buffer  } 
gotoxyd,  1);  {  Cursor  to  the  upper  left  corner  of  the  window  } 

textbackground (0) ;  {  black  background  } 

textcolor (15) ;  {  white  characters  } 

write ( '  ' ) ; 

window (15, (20-ENTRY)  shr  1+4, 65, (20-ENTRY)  shr  1  +3+ENTRY) ; 


gotoxyd,  ENTRY); 

Numwind  :=  0; 
end; 

PrintData; 
until  not (GetNext) ; 
window (14, (20-ENTRY)  shr  1  +5+ENTRY, 65, (20-ENTRY)  shr  1  +6+ENTRY); 


{  return  Cursor  to  old  position  } 
{  start  count  with  0  again  ) 

{  output  data  of  entry  } 
{  does  another  entry  exist  ?  ) 


gotoxy(l,  1); 
textbackground (7) ; 
textcolor (0) ; 
write (' 
gotoxy(2,  1)  ; 
case  NumEntries  of 
0  :  write ('no  file  found  '); 

1  :  write ('found  a  file  '); 
else  write (NumEntries, '  files  found 
end; 

window (1,  1,  80,  25); 
end; 


{  Cursor  to  the  upper  left  corner  of  window  } 
{  white  background  ) 
{  black  characters  } 
•); 


{  set  whole  display  as  window  } 


^ ********************************************************************* j 

(**  MAIN  PROGRAMM  **} 

^ ********************************************************************* ^ 


begin 

Dir; 


{  Load  Directory  and  display  ) 
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end. 

In  the  above  Pascal  program  and  in  the  following  C  program,  accessing  the  DTA 
is  much  easier  than  in  the  BASIC  version  of  the  same  program.  RECORD  or 
STRUCT  defines  the  structure  of  the  directory  entry  into  the  DTA,  and  the 
programs  implement  a  variable  of  this  type.  DOS  function  1  AH  then  transfers  the 
DTA  to  this  variable.  All  the  information  in  a  directory  entry  can  be  easily 
accessed.  With  Turbo  Pascal,  the  display  design  is  particularly  easy.  Turbo  Pascal 
also  has  a  procedure  to  deEne  any  display  area  as  a  window.  However,  the  C 
language  program  uses  the  scroll  function  of  the  BIOS  interrupt  lOH  to  scroll  the 
directory  window  one  line  upward. 

C  listing:  DIRC.C 

/*-k*-k1fk-kit*-k-k-k-k*-k*-k*-k*-k-k-k-k-kifk-kit*-k-k-k-k-kifk-kic-k-k-kifk-k-k-k*-k*-k-k-k-k*it**-k-k**ic**1fk-k*^ 


/*  D  I  R  C  */ 

/* - */ 

/*  Task  :  Displays  all  files  in  any  Directory,  */ 

/*  including  Sub-Directories  and  volume  names  */ 

/*  on  the  screen.  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  developed  on  :  08/15/87  */ 

/*  last  Update  :  04/08/89  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  MSC  DIRC;  */ 

/*  LINK  DIRC;  */ 

/*  Call  :  DIRC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  With  the  RUN  command  in  the  command  line  */ 

/*  Info  Arguments  can  be  passed  to  the  program  with  */ 

/*  the  OPTION/ARGS  command  in  the  command  line  */ 

/*  of  TURBO  C  */ 

/*  or  */ 

/*  */ 

/*  Creation  :  TCC  DIRC  */ 

/*  Call  :  DIRC  */ 

/***************************************************************★*****/ 

♦include  <dos.h>  /*  include  Header  files  */ 

♦include  <io.h> 

♦Include  <strlng.h> 

♦define  FALSE  0  /*  Constants  make  reading  of  */ 

♦define  TRUE  1  /*  Program  text  easier  */ 

♦define  byte  unsigned  char 

♦define  ENTRY  14  /*  this  many  directory  entries  fit  on  the  screen  */ 

♦define  EZ  (20-ENTRY  »  1)  /*  first  line  of  Directory  window  */ 

♦define  NRM  0x07  /*  white  characters  on  black  background  */ 

♦define  INV  0x70  /*  black  characters  on  white  background  (inverted)  */ 

/* —  this  is  the  format  of  a  Directory  entry  returned  by  - */ 

/* —  the  functions  4EH  and  4FH  */ 

struct  DirStruct  { 

byte  Reservebuf [21] ; 

byte  Attribute; 

unsigned  int  Ftime; 
unsigned  int  Fdate; 
unsigned  long  Fsize; 
char  Fname[13]; 

}; 
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/★★★★★★★★★★★★★★★★★★★★★A***********************************************/ 

/*  GETPAGE  :  gets  the  current  display  page  */ 

/*  Input  :  none  */ 

/*  Output  :  see  above  */ 

/*********************************************************************/ 

byte  GETPAGE 0 


{ 

union  REGS  Register;  /*  Register-Variable  for  Interrupt  call  */ 


Register. h. ah  =  15; 

int86(0xl0,  &Register,  ^Register) ; 

return (Register. h.bh) ; 

} 


/*  Function  number  */ 
/*  Call  Interrupt  lOH  */ 
/*  Number  of  current  display  */ 


Z*********************************************************************/ 


/*  SCROLLUP:  moves  a  display  area  one  or  more  lines  */ 
/*  upward  or  erases  it  */ 
/*  Input  :  see  above  */ 
/*  Output  :  none  */ 
/*  Info  :  if  0  is  passed  as  number,  the  display  area  */ 
/*  is  filled  with  blanks  */ 


/★******★**★★★★*★*★★★**★**★****★****★*★*★*★★*★*★★★★★★*★★*★*★★★★*★*★★★★/ 


void  ScrollUp (Number,  Color,  ColumnUL,  LineUL,  ColumnLR,  LineLR) 
int  Number;  /*  Number  of  lines  to  be  scrolled  */ 

int  Color;  /*  Color  or  attribute  for  blanks  */ 

int  ColumnUL;  /*  Column  in  the  upper  left  corner  of  display  area  */ 
int  LineUL;  /*  Line  in  the  upper  left  corner  of  the  display  */ 

int  ColumnLR;/*  Column  in  the  lower  right  corner  of  the  display  area  */ 
int  LineLR;  /*  Line  in  the  lower  right  corner  of  the  display  area  */ 


/*  Register-Variable  for  Interrupt  call  */ 


( 

union  REGS  Register; 

Register. h. ah  =  6; 

Register. h. a 1  =  Number; 

Register. h.bh  =  Color; 

Register. h.ch  =  LineUL; 

Register. h. cl  =  ColumnUL; 

Register. h.dh  =  LineLR; 

Register. h.dl  =  ColumnLR; 
int86(0xl0,  &Register,  sRegister) ; 

} 


/*  Function  number  */ 
/*  Number  of  lines  */ 
/*  Color  of  blank  line(s)  */ 
/*  Coordinates  of  the  scroll  */ 
/*  end  or  erase  */ 
/*  Set  display  window  */ 

/*  Call  Interrupt  lOH  */ 


/******  It*  *************  *****************  ****************/ 

/*  SETPOS  :  sets  the  position  of  the  cursor  in  current  display  page  */ 


/*  Input  :  see  above  */ 
/*  Output  :  none  */ 
/*  Info  :  the  position  of  the  blinking  display  cursor  is  changed  */ 
/*  by  the  call  of  this  function  only  when  the  */ 
/*  display  page  indicated  is  the  current  display  page  */ 
/*  */ 


/*********************************************************************/ 


void  SetPos (Column,  Line) 

int  Column;  /*  new  Cursor  column  */ 

int  Line;  /*  new  Cursor  line  */ 


( 

union  REGS  Register;  /*  Register-Variable  for  Interrupt  call  */ 


Register. h. ah  =2; 

Register. h.bh  =  GETPAGE (); 
Register. h.dh  =  Line; 

Register. h.dl  =  Column; 
int86(0xl0,  SRegister,  ^Register) ; 

} 


/*  Function  number  */ 
/*  Display  page  */ 
/*  Display  line  */ 
/*  Display  column  */ 
/*  Call  Interrupt  lOH  */ 
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/*****★****************★******************★*********★*****************/ 
/*  GETPOS  :  Get  the  position  of  the  Cursor  in  current  display  page  */ 

/*  Input  :  none  */ 

/*  Output  :  see  below  */ 

/**★*★* **★★★**** ************************************** ****************/ 


void  GetPos (Column,  Line) 
int  *Column; 
int  *Line; 


/*  Column  where  the  Cursor  is  located  */ 
/*  Line  where  the  Cursor  is  located  */ 


{ 

union  REGS  Register;  /*  Register-Variable  for  Interrupt  call  */ 


Register. h. ah  =  3; 

Register. h.bh  =  GETPAGE  () ; 
int86(0xl0,  &Register,  ^Register) ; 
*Column  «  Register.h.dl; 

*Line  =  Register. h.dh; 


/*  Function  number  */ 
/*  Display  page  */ 
/*  Call  Interrupt  lOH  */ 
/*  Read  result  of  the  Function  */ 
'  /*  from  the  Registers  */ 


/*********★*★****************★***★********★********★***★*****★★*★****★/ 


/*  WRlTECHAR:  writes  a  character  with  an  attribute  to  the  current  */ 
/*  cursor  position  on  the  current  display  page  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 


/**★*********** ************* ***************************** ****** ***★**★/ 


void  WriteChar (Character,  Color) 

char  Character;  /*  Character  for  output  */ 

int  Color;  /*  its  Attribute  or  color  */ 


{ 

union  REGS  Register;  /*  Register-Variable  for  Interrupt  call  */ 


Register .h. ah  =  9; 

Register .h.al  «  Character; 
Register. h.bh  =  GETPAGE(); 
Register. h.bl  =  Color; 
Register.x.cx  =1; 
int86(0xl0,  &Register,  & Register) ; 

} 


/*  Function  number  */ 
/*  character  for  output  */ 
/*  Display  page  */ 
*  Color  of  character  for  output  */ 
/*  output  character  only  once  */ 
/*  Call  Interrupt  lOH  */ 


/*  WT  :  writes  a  character  string  with  constant  color  starting  */ 
/*  at  a  specified  position  on  the  current  display  page.  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 
/*  Info  :  Text  is  a  Pointer  to  a  character  Vector,  which  contains  */ 
/*  the  text  to  be  output  and  is  terminated  with  a  '\0'  */ 
/*  character.  */ 


void  WT (Column,  Line,  Text,  Color) 

int  Column; 

int  Line; 

char  *Text; 

int  Color; 


/*  Display  column  for  output  */ 
/*  Display  line  for  output  */ 
/*  Text  for  output  */ 
/*  Color/Attribute  of  the  Text  */ 


{ 

union  REGS  Register;  Register-Variable  for  Interrupt  call  */ 


SetPos (Column,  Line) ; 
while  (*Text) 

{ 


/*  Set  Cursor 
/*  Output  Text  up  to  '\0'  character 


WriteChar ( '  ' ,  Color) ; 

Register. h. ah  =  14; 

Register. h.bh  =  GETPAGEO; 
Register. h.al  =  *Text++; 
int86(0xl0,  &Register,  ^Register) ; 


/*  Indicate  color 
/*  Function  number 
/*  Display  page 
/*  of  character  to  be  output 
/*  Call  Interrupt 


} 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 
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/**★**★**★**★*★**★★*★★****★**★**★**★***********★★★**★**★*******★★**★*★/ 


/* 

/* 

CLS 

:  Clear  current  display  and  set  Cursor  into  upper  left 
corner 

*/ 

*/ 

/* 

Input 

:  none 

*/ 

/* 

Output 

:  none 

*/ 

z****************************** *********************** *********★******/ 
void  Cls  0 
{ 

ScrollUp(0,  NRM,  0,  0,  IS,  24); 

SetPos(0,  0); 

} 

Z******************************************************** ****** *★**★**/ 


/*  BUILDSCREENDISPLAY:  prepares  the  display  for  the  output  of  the  */ 
/*  Directory.  */ 
/*  Input  :  none  */ 
/*  Output  :  none  */ 


Z*********A***********************************************************z 


/*  Clear  Screen  */ 
/*  Set  Cursor  */ 


void  Bui IdScreenDi splay  0 


{ 

byte  i;  /*  Loop  Counter  */ 

Cls  0 ;  /*  Clear  Screen  */ 

WT(14,EZ,  -r - T - T - T - T - ^l^/NOF); 

WT(14,EZ+1,- 1  Filename  |  Size  1  Date  I  Time  |RHSVDr,NOF); 

WT(14,EZ+2, '•  I - h - H - H - ^ - r,NOF); 

for  (i  =  EZ+3;  i  <  EZ+3+ENTRY;  i++) 

WT(14,i,  •’I  II  I 

WT  (14,EZ+ENTRY+3,«L - 1 - - ^1- 

NOF)  ; 

) 


••,NOF); 
± - 


Z*t**************************************** ******************** *******z 
/*  PRINTDATA:  Output  information  about  an  entry  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 
Z*********************************************************************z 


void  PrintData (DirEntry,  Line) 

struct  DirStruct  *DirEnt'ry;  /*  a  Directory  entry  */ 

byte  Line;  /*  Display  line  of  entry  */ 

byte  i;  /*  Loop  Counter  */ 

static  char  *Month[]  =  /*  Vector  with  Pointer  to  name  of  month  */ 

{ 

'•JAN'',  "FEB':,  "MAR",  "APR",  "MAY",  "JUN", 

"JUL",  "AUG",  "SEP",  "OCT",  "NOV",  "DEC" 

}; 

SetPos(15,  Line);  /*  Set  Cursor  position  for  file  name  */ 

for  (i=0;  (*DirEntry) .Fname[i]  &&  i<15  ;  printf("%c",  (*DirEntry) .Fname [i++] ) ) 

SetPos(28,  Line);  /*  Set  Cursor  position  for  file  size  */ 

printf ("%71u",  (*DirEntry) .Fsize) ;  /*  Output  file  size  */ 

SetPos(36,  Line);  /*  Set  Cursor  position  for  Date  */ 

printf ("%s-%2d-%4d".  Month [( (*DirEntry) .Fdate  »  5  &  15)  -  1], 

(♦DirEntry) .Fdate  &  31,  ( (*DirEntry) .Fdate  »  9)  +  1980); 

SetPos(49,  Line);  /*  Set  Cursor  position  for  Time  */ 

printf ("%2d:%2d", (*DirEntry) .Ftime  »  11, (*DirEntry) .Ftime  »  5  &  63); 
SetPos(59,  Line);  /*  Set  Cursor  position  for  Attribute  */ 

for  (i  =  1;  i  <=  16;  i  «=  1) 
if  ( (*DirEntry) .Attribute  &  i)  printf ("X"); 
else  printf ("  ") ; 
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/★***★★ ★★★**★★**★**★*★★*★********★*** ★★★******■***★**★★*** ★*******★★*★*/ 
/*  GETNEXT  :  read  the  following  Directory  entry  */ 

/*  Input  :  none  */ 

/*  Output  :  TRUE,  when  an  entry  was  found,  otherwise  FALSE  */ 

/*  Info  :  the  entry  is  read  into  DTA  rem  */ 

/**★**★★★*★*★*★★***★★**★*★★★★★**★**************★**★***★***★★*★****★**★/ 

byte  Get Next  0 


union  REGS  Register; 


/*  Register-Variable  for  Interrupt  call  */ 


Register. h. ah  =  0x4F;  /*  Function  number  for  Search  of  next  entry  */ 
intdos (&Register,  ^Register) ;  /*  Call  DOS-Intr.  21H  */ 
return (! Register. x.cf lag) ;  /*  Carry-Flag  =  0:  file  found  */ 


/★****★★********★★***★**★*★★★★★★*********★★****★*★***★★★*★★★*****★★★*★/ 
/*  GETFIRST  :  read  the  first  Directory  entry  */ 

/*  Input  :  none  */ 

/*  Output  :  TRUE,  if  entry  was  found,  otherwise  FALSE  */ 

/*  Info  :  Entry  is  read  into  the  DTA  */ 

/**★*★★**★***★★**★**★★**★*★*★*★**************★*********★★*★★★**★**★★**/ 


byte  GetFirst  (Sname,  Attribute) 

char  * Sname; 

unsigned  int  Attribute; 


/*  file  to  be  found  */ 
/*  the  Search  Attribute  */ 


union  REGS  Register; 
struct  SREGS  Segmente; 


/*  Register-Variable  for  Interrupt  call  */ 
/*  accepts  Segment  register  */ 


segread (& Segmente ) ;  /*  Read  in  content  of  Segment  register  */ 
Register. h. ah  =  0x4E;  /*  Function  number  for  search  of  first  */ 
Register. x.cx  =  Attribute;  /*  Attribute,  for  which  search  is  made  */ 
Register. x.dx  =  (unsigned  int)  Sname;  /*  Offset  address  search  path*/ 
intdosx (iRegister,  ^Register,  fiSegraente) ;  /*  Call  DOS-Intr.  21H  */ 
return (! Register. x.cf lag) ;  /*  Carry-Flag  =  0:  file  found  */ 


/*★**★★*★★★**★***★*★*★*******★***★★*★*★**★★*★****★****★***★***★*******/ 
/*  SETDTA  :  sets  the  DTA  to  a  Variable  in  the  Data  Segment  */ 

/*  Input  :  see  below  */ 

/*  Output  :  none  */ 

/★★★*★*•****•***★***★■*★★★*★★★★★*★***★★■**■*■★**★*★■*★*★*★***★*★■*★*★*★****★**/ 


void  Set DTA (Offset) 
unsigned  int  Offset; 


/*  new  Offset  address  of  the  DTA  */ 


union  REGS  Register; 
struct  SREGS  Segment; 


/*  Register-Variable  for  Interrupt  call  */ 
/*  accepts  the  Segment  register  */ 


segread (& Segment) ; 
Register. h. ah  =  OxlA; 
Register. x.dx  =  Offset; 


/*  Read  in  content  of  Segment  register  */ 
/*  Set  Function  number  for  DTA  */ 
/*  Offset  address  into  DX-Register  */ 


intdosx(&Register,  &Register,  ^Segment); 


/*  Call  DOS-Intr.  21H  */ 


/★*★*★★★*★***★*★★★*★*****★*★*★**★★★★★★**★★★*★★*★★★***★***★***★★★*★★★**/ 
/*  DIR  :  controls  the  input  and  output  of  Directories  */ 

/*  Input  :  see  below  */ 

/*  Output  :  none  */ 

/*★********★★****★*★*★★**★**★****★★***★**★★***★★★*★★**★***★***★***★***/ 


void  Dir (Sname,  Attribute) 

char  *Sname;  /*  Pointer  to  Character  Vector,  containing  search  path  */ 
int  Attribute;  /*  Attribute  of  file  to  be  found  */ 
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{ 

int  NumEntries,  /*  Total  number  of  entries  found  */ 

Numwind;  /*  Number  of  entries  in  display  */ 

struct  DirStruct  DirEntry;  /*  a  Directory  entry  */ 

SetDTA(iDlrEntry) ;  /*  DIRENTRY  is  the  new  DTA  */ 

BuildScreenDisplay () ;  /*  Construct  display  for  new  Directory  output  */ 


Numwind  =  NumEntries  =  0;  /*  no  entry  displayed  in  the  window  */ 

/*  no  entry  found  */ 

if  (GetFirst (Sname,  Attribute) )  /*  search  for  first  entry  */ 

{ 

do 


{ 

PrintData(&DirEntry,  EZ+ENTRY+2) ; 
if  (++Numwind  =»  ENTRY  ) 

{ 

Numwind  *  0; 

WT(14,  EZ+4+ENTRY, 

•'  Please  press  a  key 

getchO  ; 

WT(14,  EZ+4+ENTRY, 

M 

} 

ScrollUp(l,  NRM,  15,  EZ+3,  63,  EZ+2+ENTRY) ; 
WT(15,  EZ+2+ENTRY, 

••  II  I 

++NumEntries; 

} 

while  (GetNextO); 

} 

SetPos(14,  EZ+4+ENTRY) ;• 
switch  (NumEntries) 

{ 

case  0  :  printf(”no  files  found  ") ; 

break; 

case  1  :  printfC'one  file  found  •'); 

break; 

default  :  printf  (''%d  files  found  ",  NumEntries) 

} 


/*  output  entry  */ 
/*  Window  full  ?  */ 

/*  fill  a  window  */ 

",INV)  ; 

/*  wait  for  key  */ 
“,NRM)  ; 

I  ",NOF); 


/*********************************************************************/ 
/**  MAIN  PROGRAM  **/ 

/*********************************************************************/ 


void  main (Number,  Argument) 

int  Number; 

char  *Argument [ ] ; 

{ 


/*  Number  of  Arguments  +  1  passed  */ 
/*  Vector  with  pointer  to  Arguments  */ 


switch  (Number) 

{ 

case  1  ;  Dir  ("*.*",  ~0) 
break; 


V  V  /*  react  according  to  */ 
/*  Arguments  passed  */ 
/*  Display  all  files  in  current  */ 
/*  Directory  */ 

case  2  :  Dir (Argument [1] ,  ~0) ;  /*  Display  all  files  in  indicated  */ 
break;  /*  Directory  */ 

default  :  printf ("Invalid  number  of  ParametersNn") ; 


} 


} 
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6.8  The  EXEC  Function 

The  EXEC  function  has  been  mentioned  briefly  several  times  before  in  relation  to 
the  command  processor.  We’ll  examine  the  EXEC  function  more  fully  here  and 
describe  its  operation. 

Parent/child 

The  EXEC  function  is  one  of  the  many  DOS  functions  which  can  be  called  with 
interrupt  21 H  (function  4BH).  Generally  speaking,  this  function  lets  a  parent 
program  (main  program)  call  a  child  program  (secondary  program).  The  child 
program  is  loaded  from  a  mass  storage  device  into  memory  and  then  executes.  If 
this  child  program  doesn’t  become  resident,  the  memory  occupied  by  the  child  is 
released  following  program  execution.  The  child  program  can  also  call  another 
program  which  works  with  the  parent  program.  Tliis  creates  a  type  of  program 
chaining  limited  only  by  the  amount  of  available  RAM. 

One  example  of  the  EXEC  function  is  the  command  processor.  Using  the  EXEC 
function,  the  command  processor  executes  user-specified  programs  and  becomes  the 
parent  program.  Some  programs  (such  as  Microsoft  Word®)  permit  the  user  to 
execute  DOS  commands  from  the  main  program  using  this  function. 

The  parent  program  can  pass  parameters  to  the  child  program  in  the  command  line 
and  can  also  pass  parameters  using  the  environment  block.  It  can  also  transfer 
information  to  the  child  program  within  the  PSP.  Since  the  child  program,  like  all 
executable  programs,  has  a  PSP  preceding  it,  information  can  be  entered  into  the 
two  FCBs  within  this  PSP  and  made  accessible  to  the  child  program. 

Child  program 

After  transferring  control  to  the  child  program,  it  can  access  all  files  and  devices 
previously  opened  by  the  parent  program  (or  one  of  the  parent  programs)  with  a 
handle  function.  This  allows  the  child  program  to  read  information  from  a  file  or 
write  information  to  a  file  whose  handle  is  known  (the  child  program  doesn’t  need 
to  know  the  filename).  This  is  only  possible  if  the  handle  was  passed  by  the  parent 
program  in  one  of  the  three  methods  described,  or  if  the  child  program  refers  to  one 
of  the  five  handles  which  are  always  open.  These  file  accesses  affect  the  file 
pointer.  Since  values  are  not  reset,  these  file  accesses  become  “visible”  to  the 
parent  program  when  control  returns  to  the  parent  program. 

After  execution  of  the  child  program,  control  returns  to  the  parent  program  and 
execution  continues.  To  pass  information  (e.g.,  an  error  that  occurred  during  the 
execution  of  the  child  program),  the  child  program  can  pass  a  numeric  value  at  the 
end  of  its  execution.  This  can  be  done  using  DOS  function  4CH,  which  terminates 
a  program  and  returns  a  code  to  the  parent  program. 

The  communication  between  parent  and  child  program  functions  only  if  both 
programs  agree  on  this  return  value.  After  control  returns  to  the  parent  program,  it 
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can  determine  the  code  using  function  4DH  of  interrupt  21H.  To  use  function  4DH 
only  the  function  number  is  passed  in  the  AH  register.  The  code  passed  by  the 
child  program  is  returned  to  the  calling  (parent)  program  in  the  AL  register. 

Ending  the  child  program 

In  addition,  the  contents  of  the  AH  register  indicate  how  the  child  program 
terminated.  The  value  0  indicates  a  normal  termination,  while  1  shows  that  the 
child  program  terminated  when  the  user  pressed  <Control><C>  or 
<Control><Break>.  If  an  error  during  access  to  a  mass  storage  device  forced  the 
child  program  to  terminate,  a  code  of  2  is  passed  in  the  AH  register.  Finally  the 
value  3  indicates  that  the  child  program  terminated  from  a  call  to  function  31H,  or 
interrupt  27H;  the  child  program  then  becomes  resident  in  memory. 

As  mentioned  previously,  the  EXEC  function  can  only  load  the  child  program  if 
enough  memory  is  available.  While  DOS  can  estimate  the  memory  needed  for 
EXE  programs  fairly  accurately,  it  cannot  do  the  same  for  COM  programs.  For 
COM  programs  DOS  reserves  all  unused  memory.  Because  of  this,  a  COM 
program  cannot  call  another  program  with  the  EXEC  function,  since  DOS  reserves 
no  extra  memory.  The  same  is  true  for  many  EXE  programs.  If  a  call  to  a  child 
program  is  necessary,  the  required  memory  space  must  be  released  from  the  calling 
program  before  calling  the  EXEC  function  (see  Sections  6.4.1  and  6.4.2  for 
explanations  on  how  this  is  done). 


EXEC 


If  the  EXEC  function  is  called,  the  various  parameters  are  loaded  into  the  registers 
before  calling  interrupt  21H.  Function  number  4BH  is  passed  in  the  AH  register. 
A  value  of  0  or  3  is  passed  in  the  AL  register.  A  value  of  0  indicates  that  the 
EXEC  function  is  to  load  and  execute  the  program  while  a  value  of  3  indicates  that 
the  program  is  loaded  as  an  overlay  (without  executing  it).  The  address  of  the  name 
of  the  program  to  be  loaded  or  executed  is  passed  in  the  DS:DX  register  pair.  And 
the  address  of  the  parameter  block  is  passed  in  the  ES:BX  register  pair. 

The  program  name  is  specified  as  an  ASCII  string  and  ended  with  a  null  character 
(ASCII  code  0).  The  program  name  can  include  the  device  name  and  a  complete 
path  description.  Its  last  element  is  the  program  name  which,  besides  the  name 
itself,  must  have  the  extension  .COM  or  .EXE.  If  the  device  name  or  path 
designation  are  omitted,  the  system  searches  for  the  program  in  the  current 
directory  of  the  current  device.  Since  the  EXEC  function  cannot  execute  a  batch 
file  directly,  the  program  name  passed  cannot  contain  the  extension  .BAT. 

Batch  child 

If  a  batch  file  is  to  be  executed,  the  COMMAND.COM  (command  processor)  file 
must  be  invoked  first.  To  indicate  that  a  batch  file  should  be  executed,  the 
parameter  /c  followed  by  the  name  of  the  batch  file  to  be  executed  is  included  on 
the  command  line.  Besides  the  ability  to  execute  a  batch  file,  calling  the  command 
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I»xx:essor  with  the  /c  parameter  offos  the  option  of  calling  any  other  program,  and 
even  internal  DOS  commands  such  as  DIR. 

Besides  calling  a  program  directly,  it’s  possible  to  specify  program  names  without 
file  extensions  during  a  command  processor  call.  The  command  processor  searches 
for  an  EXE  file;  then  a  COM  file;  and  finally  a  BAT  file.  If  none  of  these  files 
exist  in  the  current  directory,  it  searches  all  directories  specified  in  the  PATH 
command.  This  chain  of  events  is  not  followed  during  a  direct  program  call 
without  the  addition  of  the  command  processor. 

The  directory  which  contains  the  command  processor  should  be  specified.  If  not 
specified,  it  will  be  loaded  from  the  path  indicated  by  the  COMSPEC  environment 
string  of  the  SET  command. 

Parameter  blocks 

Parameters  can  be  passed  to  the  command  processor  in  the  parameter  block 
following  the  program  name.  These  parameters  are  identical  to  the  parameters 
entered  from  the  keyboard  when  the  program  is  called.  How  these  parameters  affect 
the  EXEC  function  will  be  seen  shortly,  but  first  take  a  look  at  the  parameter 
block’s  structure  when  the  AL  register  contains  the  value  0.  This  block’s  address  is 
passed  to  the  EXEC  function  in  the  register  pair  ES.BX. 


1 

0-1 

Seqinent  address  of  the  environment  block 

2 

2-3 

Offset  address  of  the  command  parameter 

3 

4-5 

Segment  address  of  the  command  parameter 

4 

6-7 

Offset  address  of  the  first  FCB 

5 

8-9 

Segment  address  of  the  first  FCB 

6 

10-11 

7 

12-13 

Segment  address  of  the  second  FCB  | 

Field  1  indicates  the  segment  address  of  the  child  program’s  environment  block. 
This  block  doesn’t  require  an  offset  address  since  it  always  starts  at  a  location 
divisible  by  16,  and  therefore  its  offset  address  is  always  to  0. 

Environment  block 

The  command  processor  and  other  programs  obtain  information  from  the 
environment  block.  The  environment  block  is  a  series  of  ASCII  character  strings. 
This  information  can  include  paths  for  file  searches.  Each  string  has  the  following 
syntax,  terminated  by  a  null  character  (ASCII  code  0): 

Name  *  Parameter 

The  individual  strings  follow  each  other  sequentially  (i.e.,  the  null  character  of  one 
string  is  immediately  followed  by  the  beginning  character  of  the  next  string).  The 
environment  block  ends  with  a  null  character.  Any  environment  block  has  a 
maximum  length  of  32K. 
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The  environment  block  can  be  changed  or  modified  by  the  user  using  the  DOS 
SET  and  PATH  commands.  Programs  which  remain  resident  after  execution  are 
unaffected  by  any  changes  made  to  the  environment  block  through  these  two  DOS 
commands  once  made  resident 

If  the  parent  program  wants  to  pass  information  to  the  child  program  using  the 
environment  block,  it  can  either  construct  a  new  environment  block  (v  supplemoit 
its  own  environment  block  with  this  information.  In  the  first  case,  the  segment 
address  of  the  new  environmoit  block  is  specified  in  the  first  field  of  the  parameter 
block.  If  the  child  program  should  have  access  to  the  environment  block  of  the 
parent  program,  specify  a  value  of  0  in  this  field.  Before  turning  over  control  to 
the  child  program,  the  EXEC  function  stores  the  segment  address  of  the 
environment  block  in  the  memory  location  at  address  2CH  of  the  child  program’s 
PSP. 

If  the  child  program  is  to  use  a  new  environment  block,  it  should  contain  at  least  3 
strings  which  are  normally  part  of  the  environment  block  of  the  parent  program, 
and  are  impcHlant  to  the  command  {xocessor 

COMSPEC  *  Parameter 
PATH  =  Parameter 
PROMPT  =  Parameter 


If  a  child  program  modifies  its  environment  block,  the  parent  program’s 
environment  block  remains  unchanged  after  the  child  program  completes  its 
execution. 

Fields  2  and  3  indicate  the  command  parameters’  address  which  is  passed  to  the 
PSP  of  the  program  starting  at  address  80H.  They  must  have  the  same  structure  in 
memory  as  expected  by  DOS  in  the  PSP.  The  first  byte  indicates  the  number  of 
command  characters  minus  1,  then  follows  the  command  characters  as  normal 
ASCII  codes.  The  command  parameters  terminate  with  a  carriage  return  (ASCII 
code  13)  which  is  not  included  in  the  character  count.  The  first  character  in  the 
string  should  be  a  space  for  compatibility  with  COMMAND.COM. 

To  call  a  batch  program  (called  DO.BAT)  using  the  command  processor,  the 
following  command  parameters  must  be  specified  as  a  string  in  memory: 

DB  10,"  /C  DO.BAT", 13 

The  EXEC  function  copies  the  command  parameters  in  a  controlled  fashion  into 
the  PSP  of  the  program  to  be  executed.  It  removes  all  parameters  which  would 
redirect  the  input  or  output,  since  a  redirection  of  the  standard  input/output  can 
only  be  performed  by  the  parent  program.  The  child  program  can  still  use 
input/output  redirection  if  the  standard  input/output  handles  have  been  redirected  by 
the  parent  program  (see  Section  6.10  for  more  detailed  information  and  an  example 
of  tins  process). 
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Fields  6, 7,  10  and  11  indicate  two  FCBs  installed  in  the  PSP  at  address  5CH  or 
6CH.  If  this  is  not  required,  specify  -1  (FFFFH)  in  these  two  fields.  If  program 
execution  requires  it,  enter  the  first  two  command  parameters  in  the  two  FCBs 
with  DOS  function  29H.  Before  passing  control  to  the  child  program,  the  EXEC 
function  copies  these  two  FCBs  into  the  PSP  of  the  child  program. 

Even  though  all  registers  and  the  parameter  block  now  have  the  required  values,  the 
EXEC  function  cannot  be  called  yet.  Since  it  destroys  the  contents  of  all  registers 
up  to  the  CS  and  IP  registers  during  execution,  the  contents  of  all  registo^  must 
be  placed  on  the  stack  before  it  is  invoked.  Then  the  contents  of  the  SS  and  SP 
registers  must  be  stored  within  the  code  segment.  Only  then  can  interrupt  21H 
function  4BH  be  called  to  activate  the  EXEC  function.  After  the  EXEC  function 
ends,  the  carry  flag  signals  if  the  function  executed  normally.  Before  program 
execution  can  continue,  the  value  of  the  SS  and  SP  registers  must  be  restored, 
from  the  code  segment.  Then  the  contents  of  the  other  register  can  be  restored 
again  from  the  stack. 

The  EXEC  function  serves  a  different  purpose  when  a  value  of  3  appears  in  the  AL 
register.  In  this  case,  it  loads  a  COM  program  or  an  EXE  program  into  memory 
without  executing.  After  the  target  program  is  loaded,  control  immediately  returns 
to  the  calling  program.  In  contrast  with  sub-function  0,  the  program  loads  to  a 
memory  address  indicated  by  the  calling  program  instead  of  loading  to  any  non¬ 
specific  location.  Since  no  parameters  are  passed  to  the  loaded  program,  the 
parameter  block  has  a  different  structure  during  the  call  of  sub-function  3  than 
during  the  call  of  sub-function  0: 


Field 

Byte 

Purpose 

1 

0-1 

Segment  address  where  overlay  is  loaded 

2 

2-3 

Relocation  factor 

BefOTe  the  function  is  called,  the  segment  address  to  which  the  program  should  be 
loaded  is  speciOed  in  the  first  field  of  the  parameter  block.  If  the  calling  program 
doesn’t  have  enough  memory  available  for  loading  the  external  program,  it  should 
request  additional  memory  with  one  of  the  DOS  memory  management  functions. 
The  loaded  program  loads  directly  to  the  segment  address  indicated  with  the  offset 
address  0  since  no  PSP  precedes  the  program. 

Relocation 

The  relocation  factor  adjusts  the  segment  address  of  the  called  program.  Since  this 
factor  applies  only  to  EXE  programs  (COM  programs  cannot  have  specific 
segment  assignments),  the  relocation  factor  for  COM  programs  should  always  be 
equal  to  0.  The  relocation  factor  for  EXE  programs  should  indicate  the  segment 
address  where  the  program  will  be  loaded  to  confirm  to  the  program’s  segment 
assignments. 

After  the  program  is  loaded,  its  routines  are  ready  to  be  accessed.  The  routines  of 
the  loaded  program  should  always  be  treated  as  subroutines;  and  therefore,  called 
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with  the  machine  language  CALL  instruction.  It  must  always  be  a  FAR  type 
instruction  even  though  the  loaded  program  may  be  located  immediately  following 
the  calling  program,  but  can  never  have  the  same  segment  address.  The  offset 
address  for  CALL  is  always  lOOH  for  a  COM  program,  since  execution  always 
starts  immediately  following  the  PSP  at  address  lOOH.  This  creates  a  problem. 
Sub-function  3  prevents  the  PSP  from  loading.  Therefore  the  code  segment  of  the 
COM  program  starts  at  address  0,  not  at  the  offset  address  lOOH  (relative  to  the 
load  segment).  Since  all  jump  instructions  and  accesses  to  data  within  the  COM 
program  are  relative  to  address  lOOH  and  not  address  0,  you  cannot  execute  a  FAR 
CALL  instruction  with  the  address  of  the  load  segment  as  the  segment  address,  and 
address  0  as  the  offset  address.  The  segment  address  for  the  FAR  CALL  must 
indicate  the  address  of  the  load  segment  minus  lOH  and  the  address  lOOH  as  the 
offset  address. 

If  the  COM  program  specifically  acts  as  an  overlay  for  another  program,  entry 
addresses  other  than  address  lOOH  are  possible.  In  such  a  case,  only  the  offset 
address  for  the  FAR  CALL  instruction  changes.  The  segment  address  must  remain 
lOH  smaller  than  the  address  of  the  load  segment. 

EXEC  and  memory 

The  problem  is  different  for  EXE  programs.  If  they  are  loaded  for  execution  using 
sub-function  0,  the  EXEC  function  sets  the  code  segment  and  the  instruction 
pointer  to  the  instruction  which  was  declared  as  the  first  instruction  in  the 
assembler  source.  This  address,  however,  is  unknown  to  the  program  which  loaded 
the  EXE  program  as  an  overlay.  This  can  easily  be  remedied  by  placing  the  first 
executable  instruction  in  the  EXE  program  at  the  beginning  of  the  EXE  program. 
This  makes  its  offset  address  0.  The  EXE  program  source  must  not  be  in  the 
normal  sequence  with  the  stack  first.  In  this  case,  the  code  segment  must  be  the 
first  segment  in  the  source  to  ensure  that  it  begins  the  EXE  p-ogram. 

The  FAR  CALL  uses  the  address  of  the  load  segment  as  the  segment  address,  and 
address  0  as  the  offset  address. 

While  BASIC,  Pascal  and  C  have  commands  or  procedures  to  call  a  program  from 
another  program,  assembly  language  routines  must  use  DOS  function  4BH.  To 
help  you  further  understand  this  function,  here  is  an  example  program. 

The  framework  of  the  EXE  program  listed  in  Section  6.4.2  acts  as  the  basis  for 
this  program.  The  EXEPRG  procedure  performs  the  actual  dirty  work  in  this 
program.  It  calls  the  new  program  using  function  4BH.  Two  strings  which  contain 
the  name  of  the  program  to  be  called  and  the  necessary  parameters  are  passed  to  it 
Both  strings  end  with  the  null  character  (ASCII  code  OX  All  variables  required  by 
EXEPRG  for  execution  can  be  found  in  the  code  segment  This  offers  the 
advantage  that  the  lines  from  the  code  segment  only  must  be  copied  into  one  of  the 
application  programs  to  use  this  routine.  After  c^ling  EXEPRG,  the  carry  flag 
signals  if  an  error  occurred.  If  true  (carry  flag^l),  the  AX  register  contains  the  error 
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code  as  returned  by  the  EXEC  function  of  DOS.  If  the  called  program  executed 
correctly,  the  carry  flag  is  reset  (0)  and  the  termination  code  of  the  called  program, 
as  returned  by  DOS  function  4DH,  is  returned  by  the  AX  register. 

Within  this  program,  EXEPRG  displays  the  current  directory  using  the  command 
processor.  The  command  process^  defaults  to  the  current  d^tory  of  the  current 
device. 


*******  ****** -kit  *******************************. 


EXEC 

Task  : 

Calls  a  program  with  the  help  of  the  ’ 
EXEC  function  of  DOS.  In  this  example  ’ 
program  the  content  of  the  current  ’ 
Directory  of  the  current  device  is  displayed.  ’ 

Author 

:  MICHAEL  TISCHER 

developed  on 

:  08/01/87 

last  Update 

:  04/08/89 

assembly 

:  MASM  EXEC; 

LINK  EXEC; 

Call 

:  EXEC 

*********************************************************************** 


data 

segment  para  'DATA* 

; Definition  of  the  data-segment 

prgname 

prgpara 

db  \  command .  com** ,  0 
db  **/c  dir**,0 

;Name  of  the  program  to  be  called 
/Parameters  passed  to  program 

data 

ends 

;end  of  data-segment 

code 

segment  para  *  CODE  * 

;Definition  of  the  CODE-segment 

assume  cs;code,  ds:data. 

ss:stack 

exec 

proc  far 

mov  ax, data 
mov  ds, ax 

;Load  segment  address  of  the  data  segment 
;lnto  the  DS-register 

call  set free 

; release  unused  memory 

mov  dx, offset  prgname 
mov  si, offset  prgpara 
call  exeprg 

; offset  address  of  program  name 
;offset  address  of  command  line 
;Call  program 

exec 

mov  ax, 4C00h 
int  21h 
endp 

;end  program  with  call  of  a  DOS  function 
;on  return  of  error-code  0 

; —  SETFREE:  Release  memory  not  used  - 

; —  Input  :  ES  =  address  of  PSP 
; —  Output  :  none 

; —  Register  :  AX,  BX,  CL  and  FLAGS  are  changed 

; —  Info  :  Since  the  stack-segment  is  always  the  last  segment  in  an 
;  EXE-file,  ESrOOOO  points  to  the  beginning  and  SS:SP 

;  to  the  end  of  the  program  in  memory.  Through  this  the 

;  length  of  the  program  can  be  calculated 

set free  proc  near 
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mov 

bx,  SS 

/first  subtract  the  two  segment  addresses 

mov 

ax,  es 

/frcxn  each  other.  The  result  is 

sub 

bx,ax 

/number  of  paragraphs  from  PSP 
/to  the  beginning  of  the  stack 

mov 

ax,  sp 

/since  the  stackpointer  is  at  the  end  of 

mov 

cl,  4 

/the  stack  segment,  its  content  indicates 

shr 

ax,  cl 

/the  length  of  the  stack 

add 

bx,ax 

/add  to  current  length 

inc 

bx 

/as  precaution  add  another  paragraph 

mov 

ah, 4ah 

/pass  new  length  to  DOS 

int 

21h 

ret 

/back  to  caller 

set  free  endp 


; —  EXEPRG:  call  another  program  - 

; —  Input  :  DS:DX  =  address  of  the  Program  Name 
; —  DS:SI  =  address  of  the  Command  Line 

; —  Output  :  carry  flag  =  1  :  Error  (AX  =  Error-code) 

; —  Register  ;  only  AX  and  FLAGS  are  changed 

; —  Info  :  Program  name  and  Coiranand  Line  must  be  ASCI I-St ring 

; —  and  terminated  with  ASCII-code  0 

exeprg  proc  near 


/Transmit  Coiranand  Line  into  own  buffer  — 
;and  count  characters 


push  bx 
push  cx 
push  dx 
push  di 
push  si 
push  bp 
push  ds 
push  es 


/Store  all  registers  which  are 
/destroyed  by  the  call  to  the 
/DOS  EXEC  function 


copy para: 


mov  di, offset  comline+1 

push  cs 

pop  es 

xor  bl,bl 

lodsb 

or  al,al 
je  copy end 

stosb 
inc  bl 
cmp  bl,126 
jne  copypara 


/address  of  chars  in  Command  Line. 
CS  to  stack 
back  as  ES 

Set  character  count  to  0 
read  a  character 
is  it  a  NUL-code  (end) 

Yes  — >  copied  enough 
store  in  new  buffer 
increment  character  count 
Maximum  reached? 

No  — >  continue 


copyend :  mov 
mov 


cs:comline,bl  /store  number  of  characters 

byte  ptr  es:[di],13  /finish  coiranand  line 


mov  cs:merkss,ss  /SS  and  SP  must  be  stored  in 

mov  cs:merksp, sp  /variables  in  code  segment 


mov  bx, offset  parblock  /ES:BX  points  to  parameter  block 
mov  ax, 4B00h  /function  number  for  EXEC  function 

int  21h  /Call  DOS- function 


cli 

mov  SS, cs:merkss 
mov  sp, cs : merk  sp 
stl 


/Set  Interrupts  for  a  moment  from 
/stack  segment  and  stackpointer  to 
/their  old  values 
/Switch  Interrupt  on  again 


pop  es  /Get  all  Registers  from  stack  again 

pop  ds  ^ 

pop  bp 
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pop 

si 

pop 

di 

pop 

dx 

pop 

cx 

pop 

bx 

jc 

exeend 

/Errors?  YES  — >  end 

mov 

ah, 4dh 

/no  errors,  sense  end-code  of  the 

Int 

21h 

/program  which  was  executed 

exeend : 

ret 

/back  to  caller 

/ —  Variables  of  this 

routine  only  addressable  through  CS  — 

merkss 

dw 

(?) 

/accepts  SS  during  program  call 

merksp 

dw 

(?) 

/accepts  SP  during  program  call 

parblock 

equ 

this  word 

/Parameter  block  for  EXEC  function 

dw  0 

/environment  block 

dw  offset  comline 
dw  seg  code 
dd  0 
dd  0 

comline  db  128  dup  (?) 
exeprg  endp 


; offset  and  segment  address  of 
/modified  Command  Line 
;no  data  in  PSP  #1 
;no  data  in  PSP  #2 

/accepts  modified  Command  Line 


stack 


stack  segment  para  stack 

dw  256  dup  (?) 
stack  ends 

code  ends 

end  exec 


/Definition  of  the  stack-segment 
/the  stack  has  256  Words 
/End  of  the  stack-segment 


/End  of  the  CODE-segment 
/for  execution  start  with  EXEC 


118 


Abacus 


6.9  Memory  Allocation  from  DOS 


6.9  Memory  Allocation  from  DOS 

DOS  subdivides  the  maximum  640K  of  memory  into  roughly  two  areas.  The  first 
area  is  designated  as  the  operating  system  area.  It  begins  at  memory  location 
0000:0000  and  contains  the  interrupt  vector  table,  some  internal  tables,  buffers, 
variable  memory  and  the  operating  system  code.  This  code  retains  the  resident 
portion  of  the  command  processor  and  the  resident  and  installable  device  drivers. 
The  size  of  this  area  varies  with  the  version  of  DOS  in  use,  the  sizes  of  the  device 
drivers  installed,  and  other  factors  such  as  the  number  of  disk  buffers  available. 

The  second  area  is  designated  as  the  TP  A  (Transient  Program  Area).  It  contains 
programs  and  their  environment  blocks  for  execution.  The  TPA  starts  after  the  end 
of  the  operating  system  area.  Depending  on  the  memory  requirements  of  the 
individu^  programs,  DOS  assigns  them  different  amounts  of  memory  administered 
through  a  special  data  block  preceding  every  memory  range  and  connected  with  the 
data  block  of  the  next  memory  range.  This  also  applies  to  memory  not  assigned  to 
a  program. 

This  data  block,  called  a  memory  control  block  (or  MCB)  is  a  16-byte  block 
containing  a  variety  of  information.  An  MCB  begins  at  one  of  the  addresses 
divisible  by  16,  and  controls  memory  allocation.  DOS  looks  for  the  segment 
address  of  the  allocated  memory  range,  and  is  helped  in  this  task  through  the  MCB. 
The  following  table  shows  the  structure  of  an  MCB  in  memory: 


Address 

Contents 

Type 

+00H 

ID  ("Z"=last  MCB,  "M"=another  MCB  follows) 

1  byte 

+01H 

Segment  address  of  corresponding  PSP 

1  word 

+03H 

Number  of  paragraphs  in  allocated  range 

1  word 

+05H 

unused 

11  bytes 

+10H 

Allocated  memory  range 

X  paragraphs 

As  the  table  above  illustrates,  the  MCB  contains  three  fields.  The  first  field 
indicates  whether  any  MCBs  follow  the  current  MCB  under  analysis.  The  letters 
”M"  (more  MCBs  to  follow)  and  "Z”  (last  MCB)  are  the  initials  of  one  of  the 
creators  of  MS-DOS,  Mark  Zbikowski. 

The  second  field  specifies  the  segment  address  of  the  coresponding  program's  PSP. 
This  only  applies  when  memory  allocation  becomes  a  part  of  the  environment  of 
the  program  being  handled,  in  which  case  the  PSP  is  indicated  by  the  contents  of 
this  field.  In  most  cases,  this  field  simply  points  to  the  memory  range  needed  by 
the  program. 

The  third  field  of  the  MCB  specifies  the  size  of  the  corresponding  memory  range  in 
paragraphs.  Next  follows  the  memory  range  itself,  then  any  further  MCBs  after 
that  (provided  that  the  first  field  contains  an  "M"  ID  letter).  MCBs  can  be  linked 
together  to  create  a  group,  as  shown  in  the  figure  below: 
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Start  of  memory 
(0000:0000) 

Start  of  TPA 


End  of  TPA 
End  of  memory 


5 

Memory  Control  Block 

1 

Controlled  by  Memory 

Control 

Block 

1 

Memory  Control  Block 

2 

Controlled  by  Memory 

Control 

Block 

2 

Memory  Control  Block 

3 

Controlled  by  Memory 

Control 

Block 

3 

Memory  Control  Block 

4  (last 

MCB) 

Controlled  by  Memory 

Control 

Block 

4 

s  ' 

Memory  allocation 

If  the  DOS  EXEC  loader  loads  and  executes  a  program,  this  function  immediately 
requests  two  data  areas  through  another  DOS  function.  The  first  of  these  two  areas 
stores  the  environment  block,  while  the  second  accepts  the  current  program  and  the 
program's  PSP.  The  size  of  the  area  made  available  to  a  program  is  difficult  to 
estimate  from  the  EXEC  loader.  This  is  even  more  difficult  for  COM  programs 
than  for  EXE  programs  since  COM  programs  are  copies  of  memory  contents  and 
have  no  information  preceding  them.  DOS  therefore  defaults  to  the  maximum  and 
reserves  the  total  available  memory  for  a  COM  program. 


This  method  worked  well  in  the  early  days  of  DOS,  but  has  created  other 
problems.  While  only  one  program  could  exist  in  memory  at  a  time  in  the  early 
days  of  DOS,  now  it’s  common  fot  one  program  to  load  and  run  a  second  program, 
or  even  make  one  of  the  programs  permanently  resident  in  memory.  This  can’t  be 
done  if  no  memory  exists,  as  would  be  the  case  after  loading  a  COM  program. 
This  is  why  a  COM  program  should  always  release  the  memory  it  no  longer  needs 
after  it  starts  (see  Section  6.4.1  for  details  on  how  this  happens). 


A  COM  program  can  only  load  when  a  memory  range  large  enough  to 
accommodate  the  COM  program  exists  (plus  256  bytes  for  the  PSP  and  at  least  2 
bytes  for  the  stack).  The  COM  program  ensures  that  enough  memory  is  available. 
Under  the  minimum  conditions  presented  above,  the  program  probably  won’t  run 
without  errors,  since  few  programs  can  operate  with  only  a  2-byte  stack. 

EXE  program  files  have  a  set  of  information  created  by  the  linker.  The  EXEC 
load^  can  determine  the  amount  of  memory  required  for  code  segment,  data  and 
stack  from  this  information.  The  start  of  the  EXE  program  itself  contains 
additional  information  about  the  amount  of  memory  needed  for  the  program.  This 
amount  defines  an  upper  and  lower  limit  of  the  additional  memory,  rather  than  a 
specific  number  of  bytes.  The  EXEC  loader  tries  to  reserve  the  upper  limit  of 
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memory  if  it  can.  If  this  is  not  possible,  the  EXEC  loader  uses  the  lower  limit  or 
reserves  the  remainder  of  memory.  If  the  lower  limit  of  memory  cannot  be 
allocated,  the  loading  process  aborts  and  control  returns  to  the  program  which 
called  the  EXEC  loader  (in  most  cases,  the  command  processor). 

The  same  occurs  after  program  execution  when  the  EXEC  loader  releases  the 
reserved  memory  space  for  further  use,  unless  prevented  by  function  31H  of 
intOTupt  2IH,  called  from  the  program. 

Now  that  you  know  some  of  the  theoretical  aspects  of  DOS  memory  management, 
here  are  descriptions  of  the  most  important  of  these  DOS  functions.  Functions 
48H,  49H  and  4AH  are  all  called  through  interrupt  21H.  The  function  number  is 
passed  in  the  AH  register. 

Function  48H  allocates  memory.  The  function  number  is  passed  in  the  AH  register 
and  the  number  of  paragraphs  to  be  reserved  (16  bytes  per  paragraph)  is  passed  in 
the  BX  register.  If  the  requested  numb^  of  paiagr2q)hs  can  be  reserved,  the  function 
returns  with  the  carry  flag  clear.  The  AX  register  indicates  the  segment  address  of 
the  reserved  memory.  Therefore,  it  starts  at  address  AXiOOOO.  If  the  program 
required  more  memory  than  was  available,  the  carry  flag  is  set  following  the  call  to 
the  function  and  the  AX  register  contains  an  error  code.  The  BX  register  contains 
the  maximum  mem(»*y  available  in  paragraphs. 

Function  49H  performs  the  reverse  of  function  48H.  This  function  releases 
memory  previously  reserved  through  function  48H.  The  segment  address  of  the 
memory  area  to  be  released  is  passed  in  the  ES  register.  This  segment  address  was 
originally  passed  in  the  AX  register  when  function  48H  was  called.  Normally 
function  49H  should  execute  without  errors  and  the  carry  flag  should  be  reset  after 
the  function  call.  If  this  is  not  the  case,  it  could  be  caused  by  either  a  destroyed 
data  block  (placed  ahead  of  a  memory  area  by  DOS),  or  a  segment  address  passed  in 
the  ES  register  which  doesn’t  match  a  reserved  memory  area. 

A  third  function  changes  the  size  of  memory  area  which  had  been  previously 
reserved.  The  memory  area  can  be  either  enlarged  or  reduced  by  using  function 
4  AH.  The  segment  address  of  the  area  to  be  modified  is  passed  in  the  ES  register. 
The  BX  register  reserves  the  number  of  paragraphs  (16-byte  units)  which  the 
memory  area  should  contain.  The  register  contents  following  the  call  to  the 
function  are  identical  to  those  of  function  48H. 

Since  calling  DOS  functions  is  relatively  easy  as  far  as  memory  management  is 
concOTied  and  no  special  tricks  are  required,  the  following  program  is  dedicated  to  a 
different  topic,  which  also  relates  to  DOS  memory  management.  We're  talking 
about  a  program  that  pokes  around  the  system  and  checks  all  allocated  memory  as 
well  as  its  contents.  The  program  is  intelligent  enough  to  differentiate  between 
storage  areas  that  contain  the  environment  of  a  program,  a  PSP,  or  other 
information. 
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The  assignment  of  this  program  is  to  go  through  the  memory  from  MCB  to  MCB 
and  examine  the  allocated  storage  areas.  In  order  to  move  to  the  next  MCB  each 
time,  it  uses  the  third  field  within  an  MCB,  which  helps  it  point  to  the  next 
MCB.  This  sets  up  a  loop  which  will  run  until  the  last  MCB  is  ^scovered,  which 
will  have  the  letter  ”Z”  in  its  ID  field. 

But  in  ordCT  to  move  through  the  chain  of  MCBs,  the  address  of  the  first  link,  that 
is  the  first  MCB,  must  be  known.  DOS  lists  this  within  an  internal  structure 
called  DIB  (DOS  Information  Block),  which  is  not  normally  accessible  to 
application  programs,  i.e.  this  represents  an  undocumented  DOS  feature  (see  also 
Section  6.15).  However,  we  can  find  out  the  address  of  this  structure  with  the  help 
of  function  52H,  which  will  output  the  address  to  the  ES:BX  register  pair  when 
called. 

Curiously,  this  address  points  to  the  second  field  in  the  MCB  rather  than  the  first 
But  since  it's  the  first  field  that  contains  the  address  of  the  first  MCB,  the 
information  we're  looking  for  is  behind  the  pointer.  Since  the  pointer  on  the  first 
MCB  consists  of  an  offset  address  and  a  segment  address,  it  is  four  bytes  long  and 
can  therefore  be  found  at  the  address  ES:(BX-4).  But  be  careful  with  the  address 
statement,  because  it  makes  it  seem  as  though  all  you  have  to  do  is  subtract  4 
from  the  contents  of  the  BX  register  in  order  to  get  the  effective  address  of  the 
desired  information  in  the  ES:BX  register  pair.  This  will  only  be  successful  if  the 
offset  address  in  the  BX  register  is  greater  than  or  equal  to  4.  But  if  it  is  less  than 
4,  the  consequences  are  disastrous,  because  this  leaves  a  negative  number.  There  is 
no  such  thing  as  a  negative  memory  address.  Let's  use  an  example  to  make  this 
clear 

If  the  value  0  is  returned  to  the  BX  register  as  the  offset  address  of  the  DIB,  the 
subtraction  would  give  the  value  OFFFCH.  With  arithmetic  operations,  this  is 
interpreted  quite  correctly  as  -4.  However,  during  memory  access,  this  will  not 
point  to  the  ^dress  -4,  but  rather  right  to  OFFFCH,  and  therefore  to  the  end  rather 
than  the  beginning  of  the  accompanying  segment.  Of  course,  you  won't  find  what 
you're  looking  for  there. 

The  program  will  help  you  here,  first  of  all  by  decrementing  the  delivered  segment 
address  by  1.  This  reduces  the  effective  address,  which  you  get  by  appending  the 
segment  address  and  the  offset  address,  by  16.  Finally,  by  adding  12  to  the  offset 
address,  the  effective  address  is  reduced  by  only  4  and  points  to  the  desired  mernwy 
location.  The  address  of  the  first  MCB  can  then  be  taken  from  this  memory 
location  without  any  problems. 

The  loop  which  runs  through  all  MCBs  and  analyzes  them  begins  with  this 
address.  First,  some  status  information  on  the  MCB  and  the  memory  it  controls  is 
given.  This  includes: 

•  the  MCB  number 

•  its  address  in  memory 
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•  the  address  of  the  memory  it  controls 

•  the  contents  of  the  ID  field  ("M”  or  ”Z”) 

•  the  address  of  the  accompanying  PSP  (indqiendent  of  whetho-  it 
even  exists) 

•  the  size  of  the  accompanying  sUx^e  area  in  paragraphs  and  bytes 

Next,  the  contents  of  the  storage  area  that  belongs  to  it  are  examined.  We  get  its 
address  by  incrementing  the  segment  address  of  the  MCB  by  1.  The  first  thing 
well  determine  is  whether  we’re  dealing  with  an  environment  block  in  this  storage 
area.  We’ll  know  for  sure  if  we  find  the  string  COMSPEC=  at  the  beginning  of  the 
area.  This  string  starts  every  environment  block.  If  this  string  is  found,  the 
program  proceeds  as  though  this  were  indeed  an  environment  block,  and  it  lists  the 
individual  environment  strings.  In  front  of  these,  it  lists  the  name  of  the  program 
the  environment  block  belongs  to,  which  is  located  at  the  end  of  the  environment 
block  for  DOS  version  3.0  and  higher. 

If  the  storage  area  cannot  be  identified  as  an  environment  block,  we  could  possibly 
be  dealing  with  a  PSP,  and  therefore  a  transient  or  resident  program.  The  program 
will  start  from  here  if  it  finds  the  machine  language  command  INT  20H  (code 
OCDH,  020H)  in  the  first  two  positions  of  the  memory  range.  This  command 
starts  every  PSP. 

If  the  program  also  does  not  run  into  this,  it  can’t  tell  if  the  memory  range 
contains  program  code,  data,  or  whatever.  In  this  case,  the  program  will  send  the 
first  80  bytes  of  the  storage  area  to  the  screen  as  a  hex  and  ASCII  dump,  in  order 
to  give  you  a  chance  to  figure  it  out  for  yourself. 

After  this,  the  user  is  prompted  to  strike  any  key.  When  the  keystroke  is  received, 
the  next  MCB  is  examined,  and  the  program  will  finally  end  when  the  last  MCB 
has  been  handled. 

The  following  programs  in  Pascal  and  C  produce  the  MCB  dump.  A  BASIC 
version  could  not  be  implemented  here  because  this  program  works  its  way 
through  the  entire  memory,  and  BASIC  offers  only  the  DEF,  SEG  and  PEEK 
commands  for  this  purpose.  The  use  of  these  commands  is  too  awkward  in  this 
case  and  would  detract  tom  the  real  task  of  the  program. 

Since  both  programs  are  very  similar  in  terms  of  the  logic,  function  calls,  and 
variables  used,  they  are  described  together  in  the  following  section. 

Both  access  memory  with  FAR  pointers,  since  the  storage  areas  to  be  addressed  are 
outside  of  their  data  segments.  While  Turbo  Pascal  automatically  uses  FAR 
pointers,  C  requires  selection  of  the  appropriate  memory  configuration  through 
Compact,  Huge,  Large  or  with  the  help  of  Cast  operations,  each  of  which 
explicitly  defines  the  task  with  a  FAR  pointer.  This  program  goes  the  latter  way, 
so  that  it  may  also  be  compiled  in  a  memory  configuration  that  works  with  NEAR 
pointers  by  default  (Tiny,  Small,  Medium). 
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Converting  separately  retrieved  offset  and  segment  addresses  to  one  FAR  pointer 
presents  a  problem  in  both  languages.  This  can  be  done  in  C  with  a  macro,  which 
is  already  defined  in  the  Include  file  E>OS.H  in  Turbo  C,  but  is  missing  in 
Microsoft  C.  For  this  reason,  the  macro  is  defined  within  the  C  program,  in  case  it 
hasn't  been  i^viously  defined.  In  Pascal,  the  address  conversions  happen  with  the 
help  of  a  small  inline  procedure,  that  enters  both  addresses  directly  into  the 
memory  locations  that  form  the  pointer. 


Beyond  these  Inief  remarks,  the  listings  should  be  able  to  speak  for  themselves, 
since  they  are  fully  documented. 


Pascal  listing:  MEMP.PAS 

I *******A****A*********A******************* «★**★****★***★ *«*★*★*★******} 


* 

MEMP 

* 

* 

Description 

:  displays  the  memory  blocks 

allocated  by  DOS.  * 

* 

Author 

:  MICHAEL  TISCHER 

* 

* 

developed  on 

;  08/22/1988 

* 

* 

last  update 

:  08/22/1988 

* 

I ********************************************************************** I 

program  MEMP; 


uses  DOS,  CRT; 

type  BytePtr  *  '"byte; 

Range  =  array [0. . 1000]  of  byte; 


RngPtr  *  '"Range; 

MCB  *  record 

IdCode 

:  char; 

PSP 

:  word; 

Distance 

:  word; 

end; 

MCBPtr  =  ^MCB; 

MCBPtr2  =  ^MCBPtr; 

HexStr  =  string  [4]-; 

var  CvHStr  :  HexStr; 

{  bind  in  the  DOS  and  CRT  units  } 

{  pointer  to  a  byte  } 
{  an  area,  anywhere  in  RAM  } 

{  pointer  to  an  area  } 
{  a  memory  control  block  } 
"M"  =  a  block  follows,  "Z"  *  end  } 
{  segment  address  of  the  PSP  } 
{  number  of  paragraphs  -  1  } 

{  pointer  to  an  MCB  } 
{  pointer  to  an  MCBPtr  } 
{  stores  a  four-digit  hex  string  } 

{  stores  the  converted  hex  string  } 


I *★★★★★★*★*«★★**★************★*★★★★******★★★★**★*★*★★*★**★*★**★****★*★* I 

{*  GetDosVer:  determines  the  DOS  version  *} 

{*  Input  :  none  *} 

{*  Output  ;  the  DOS  version  number  (30  for  DOS  3.0,  33  for  3.3  etc.)  *} 

I ********************************************************************** ^ 


function  GetDosVer  :  byte; 


var  Regs  :  Registers; 


stores  the  processor  registers  } 


begin 

Regs. ah  $30;  {  function  no.  for  "Get  Dos  Version"  } 

MsDos  (  Regs  );  {  call  DOS  Interrupt  $21  } 

GetDosVer  :=  Regs.al  *  10  +  Regs. ah;  {  get  version  number  } 

end; 


I  ************** *********************^****«**** ********************* *****^ 


*  MK_FP:  creates  a  byte  pointer  out  of  the  segment  and  offset  *} 

*  addresses  passed.  *} 

*  Input  :  -  Seg  =  segment  to  which  the  point  should  point  *} 

*  -  Ofs  »  offset  address  to  which  the  pointer  should  point  *} 

*  Output  :  the  pointer  *} 
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{*  Info  :  The  pointer  returned  can  be  cast  to  any  type  pointer  *} 
^*******11****  *****************************  11****************************^ 

{$F+}  {  This  routine  is  intended  for  the  FAR  model  and  is  } 

{  also  suited  for  binding  into  a  unit.  } 

function  MK_FP(  Seg,  Ofs  :  word  )  :  BytePtr; 

begin 

Inline  (  $8B  /  $46  /  $08  /  {  mov  ax,  [1:^+8]  (get  segment  address)  } 

$89  /  $46  /  $FE  /  {  mov  [bp-2], ax  (and  put  in  pointer)  } 

$8B  /  $46  /  $06  /  {  mov  ax, [bp+6]  (get  offset  address)  } 

$89  /  $46  /  $FC  );  {  mov  [bp-4], ax  (and  put  in  pointer)  } 

end; 


{$F-}  {  NEAR  routines  possible  again  } 

[**********************************************************************'^ 
{*  HexString:  creates  a  4-dlgit  hex  string  out  of  the  number  passed  *} 
{*  Input  :  -  HexVal  =  the  number  to  be  converted  *} 

{*  Output  :  the  hex  string  *} 

{★★★★★★*****★★★★★★★«★★*****««**«««««**«««««««*«««***«««*«**«««****««*** j 

function  Hexstring (  HexVal  ;  word  )  :  HexStr; 


var  Counter,  {  loop  counter  } 

Nibble  :  byte;  {  the  lowest  nitole  of  the  word  } 

begin 

CvHStr  :*  'xxxx';  {  initialize  the  string  } 

for  Counter;=4  downto  1  do  {  run  through  the  4  digits  of  the  string  } 
begin 

Nibble  :=  HexVal  and  $000f;  {  leave  just  the  lower  4  bits  } 

if  (  Nibble  >  9  )  then  {  convert  to  a  letter?  } 

CvHStr [  Counter  ]  :=  chr (Nibble  -  10  +  ord('A'))  {  yes  } 

else  {  convert  to  a  number  } 

CvHStr [  Counter  ]  : =  chr (Nibble  +  ord ( ' 0 ' ) ) ; 

HexVal  :=  HexVal  shr  4;  {  shift  HexVal  4  bits  to  the  right  } 

end; 

HexString  :=  CvHStr;  {  return  the  created  string  } 

end; 


{*  FirstMCB:  Returns  a  pointer  to  the  first  MCB.  *} 
{*  Input  :  none  *} 
{*  Output  :  pointer  to  the  firs  MCB  *} 
[******************************************************■!,*******  ********^ 

function  FirstMCB  :  MCBPtr; 


var  Regs  :  Registers;  {  stores  the  processor  registers  } 

begin 

Regs. ah  :=  $52;  {  ftn.  no.:  get  address  of  the  DOS  info  block  } 

MsDos(  Regs  );  {  call  DOS  interrupt  $21  } 

{* —  ES: (BX-4)  points  to  the  first  MCB,  create  pointer  - *} 

FirstMCB  :=  MCBPtr2 (  MK_FP (  Regs.ES-1,  Regs.BX+12  )  )^; 
end; 


{*  Dump:  outputs  hex  and  ASCII  dump  of  a  memory  block.  *} 
{*  Input  :  -  DPtr  *  pointer  to  the  memory  block  to  be  dumped  *} 
{*  -  Num  -  number  of  lines  to  dump  (16  bytes  each)  *} 
{*  Output  :  none  *} 


procedure  Dump(  DPtr  :  RngPtr;  Num{Num}  :  byte); 


125 


6.  The  Disk  Operating  System 


PC  System  Programming 


type  HBStr  =  string [2]; 

var  Offset, 

Z  :  integer; 

HexStr  :  HBStr; 

procedure  HexByte (  HByte  :  byte  ); 


{  stores  2-digit  hex  numbers  } 

{  offset  in  the  memory  block  } 
{  loop  Counter  } 
{  stores  a  hex  number  for  hex  dump  } 


begin 

HexStr[l]  :»  chr(  (HByte  shr  4)  +  ord('O')  ); 
if  HexStr[l]  >  'S'  then  { 

HexStr [1]  :=  chr(  ord (HexStr [1] )  +  7  ); 

HexStr[2]  :«  chr(  (HByte  and  15)  +  ord('O')  ); 
if  HexStr [2]  >  '9'  then  ( 

HexStr [2]  :=  chr(  ord (HexStr [2] )  +  7  ); 

end; 


{  first  digit  } 
convert  to  letters?  } 
(  yes  } 
{  second  digit  } 
convert  to  letters?  } 
(  yes  } 


begin 

HexStr  :=  'zz'; 
writeln; 

write ('DUMP  |  0123456789ABCDEF 
writeln ('  09  OA  OB  OC  OD  OE  OF'); 


(  initialize  the  hex  string  ) 
00  01  02  03  04  05  06  07  08'); 


write  ('  — 
writeln ( • 
Offset  :» 


0; 


I  •>; 


while  Num>0  do 
begin 

write (Hexstring (Offset) , 
for  Z:=0  to  15  do 

if  (Dptr'^EOffset+Z]  >=  32)  then 
write (  chr(Dptr^[Offset+Z] )  ) 
else 

write ( '  ' ) ; 
write ( '  ' )  ; 

for  Z:=0  to  15  do 
begin 

HexByte  (  Dpt r^' [Offset +Z] 
write (HexStr,  '  ' )  ; 
end; 

writeln; 

Offset  :=  Offset  +  16; 

Dec (  Num  )  ; 
end; 

writeln; 
end; 


- •); 

{  start  with  the  first  byte  in  the  block  ) 
(  run  through  the  loop  ANZ  tiroes  } 


{  process  15  bytes  } 
{  valid  ASCII  character?  ) 
{  yes,  output  character  } 
{  no  ) 

{  output  space  instead  of  character  ) 
{  set  cursor  to  the  hex  portion  ) 
{  process  15  bytes  ) 


); 


{  convert  byte  to  hex  ) 
{  output  hex  string  } 


{  set  offset  in  the  next  line  ) 
{  decrement  number  of  remaining  lines  ) 


^********************************************<^***<^*******************^k*j 

{*  TraceMCB:  runs  through  the  list  of  MCB's.  *} 

{*  Input  :  none  *} 

{*  Output  ;  none  *} 

^ **★*★*★*★*** ***************************^t********** ******************** j 

procedure  TraceMCB; 


const  ComSpec  :  array [0.. 7]  of  char  =  •CC»1SPEC='; 


var  CurMCB{CurMCB}  :  MCBPtr; 
Done  :  boolean; 

Key  :  char; 

NrMCB, 

Z  :  integer; 

MemPtr  :  RngPtr; 

DosVer  :  byte; 


{  number  of  current  MCB  } 
{  loop  counter  } 

{  DOS  version  number  } 


begin 

DosVer  :=  GetDosVer; 
Done  ;*  false; 

NrMCB  :=  1; 

CurMCB  FirstMCB; 
repeat 


{  get  DOS  version  } 

{  the  first  MCB  is  number  1  } 
{  get  pointer  to  the  first  MCB  ) 
(  follow  the  MCB  chain  } 
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if  CurMCB''.IdCode 
Done  :=  true; 
writelnCMCB  number 
writelnCMCB  address 

writeln( 'Memory  addr. 


writelnCID 
writelnCPSP  address 
writeln ( ' Size 

'(  longint  (CurMCB'". Distance) 

write ( ' Contents  *  ' ) ; 


Z'  then  {  last  MCB  reached?  } 

{  yes  } 

=  • ,  NrMCB)  ; 

*  Hexstring  (seg  (CuiMCB'") ) , 

Hexstring  (ofs  (CuiMCB'") )  )  ; 

Hexstring  (succ  (seg  (CurMCB*^) ) ) ,  ' : ' , 
Hexstring  (ofs  (CuiMCB'') )  )  ; 

CurMCB'' .  IdCode)  ; 

Hexstring (CurMCB^.PSP) ,  • :0000' ) ; 
CurMCB'". Distance,  *  paragraphs 
shl  4,  '  bytes  )'); 


{* —  is  it  an  environment? 


Z  :*  0;  {  start  the  comparison  at  the  first  byte  } 

MemPtr  :=  RngPtr  (MK_FP  (succ  (Seg  (CurMCB'") ) ,  0));  {  pointer  in  RAM  } 

while  (  (Z<-7)  and  (ord (ComSpec [Z] )  »MemPtr^[Z])  )  do 
Inc(Z);  {  set  Z  to  the  nest  character  } 

if  Z>7  then  {  was  the  string  found?  } 

begin  {  yes,  this  is  an  environment  } 

writeln ( ' environment ' ) ; 

MemPtr  :  =  RngPtr  (MK_FP  (succ  (Seg  (CurMCB'") ) ,  0) )  ; 
if  DosVer>=  30  then  {  DOS  Version  3.0  or  higher?  } 

begin  {  yes,  get  program  name  } 

write ( 'Program  name  =  ' ) ; 

Z  :=  0;  {  start  with  the  first  byte  } 

while  not  (  (MemPtr'^  [Z]  *0)  and  (MemPtr^  [Z+ 11*0)  )  do 

Inc(  Z  );  {  search  for  empty  string  } 

Z  :=  Z  +  4;  {  set  Z  to  the  start  of  the  prog  name  } 

if  MemPtr'"  [Z]  <>0  then  {  is  there  a  prog,  name  here?  } 

begin 

repeat  {  run  through  the  program  name  } 

write  (  chr  (MemPtr'"  [Z] )  );  {  output  characters  } 

Inc(  Z  );  {  process  the  next  character  } 

until  MemPtr'" [Z]=0;  {  to  the  end  of  the  string  } 

writeln; 
end 

else  {  program  name  not  found  } 

writeln ( ' unknown ' ) ; 
end; 


{* —  output  the  environment  strings  - *} 

writeln (#13, #10,  'Environment  strings'); 

Z  :=  0;  {  start  with  the  first  byte  in  the  allocated  block  } 

while  MemPtr'"  [Z]  <>0  do  {  repeat  until  empty  string  } 

begin 

write  ( '  ' ) ; 

repeat  {  output  a  string  } 

write  (  chr  (MemPtr'"  [Z] )  );  {  print  a  character  } 

Inc(  Z  );  {  process  the  next  character  } 

until  MemPtr'"  [Z]  =0;  {  to  the  end  of  the  string  } 

Inc  (  Z  ) ;  {  set  to  the  start  of  the  next  string  } 

writeln;  {  end  line  } 

end 

end 

else  {  no  envrionment  } 

begin 


{*—  is  it  a  PSP? - *} 

{*—  (starts  with  command  INT  20  (code=$CD  $20))  - *} 

MemPtr  :=  RngPtr  (MK_FP  (succ  (seg  (CurMCB'") ) ,  0));  {  set  pointer  } 

if  (  (MemPtr'"  [0]*$CD)  and  (MemPtr'"  [1  ]  =$20)  )  then 

begin  {  it's  a  PSP  } 

writelnCPSP  (with  program  following)'); 
end 


else  {  the  ccanmand  INT  20  was  not  found  } 
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begin 

writeln ('unidentifiable  (program  or  data)'); 

Dump(  MemPtr,  5);  {  dump  the  first  5x16  bytes  } 

end; 

end; 

write  ( ) ; 
writelnC— Press  a  key  —•); 
if  (  not  Done  )  then 

begin  {  set  pointer  to  the  next  MCB  } 

CurMCB  :»  MCBPtr(MK_FP  (seg(CurMCB'")  +  CurMCB'". Distance  +  1,  0)); 
Inc(NrMCB);  {  increment  the  number  of  the  MCB  } 

Key  :=  ReadKey; 
end; 

until  (  Done  )  {  repeat  until  the  last  MCB  is  processed  } 

end; 

I  *★**★★**★★**  ************************  *****,^*****<^****************<^*****j 

{**  MAIN  PROGRAM  **} 

^ ********************************************************************** j 

begin 
ClrScr; 

TraceMCB; 
end. 

C  listing:  MEMC.C 

/★**★★**★***★*★*★******★*** ************************ ******************★*/ 


/*  M  E  M  C  */ 

/* - */ 

/*  Description  :  Displays  the  memory  blocks  allocated  by  DOS  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  developed  on  :  08/23/1988  */ 

/*  last  update  :  05/12/1989  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  creation  :  CL  /AS  /Zp  memc.c  */ 

/*  call  :  MEMC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  creation  :  via  the  Compile-Make  command  */ 

/*  (no  project  file)  */ 

/★**★★***★**★ ************************************** ********************/ 

♦include  <dos.h> 

♦include  <stdlib.h> 

typedef  unsigned  char  byte;  /*  build  ourselves  a  byte  */ 

typedef  unsigned  segadr;  /*  a  segment  address  */ 

typedef  byte  boolean; 

typedef  byte  far  *FB;  /*  FAR  pointer  to  a  byte  */ 

♦define  TRUE  1  /*  needed  for  working  with  boolean  */ 

♦define  FALSE  0 

/*==  Structures  and  unions  ===========================================*/ 

struct  MCB  {  /*  describes  an  MCB  in  memory  */ 

byte  id_code;  /*  'M'  =  a  block  follows,  'Z'  =  end  */ 
segadr  psp;  /*  segment  address  of  the  PSP  */ 

unsigned  distance;  /*  number  of  paragraphs  reserved  */ 


{  clear  the  screen  } 
{  run  through  the  MCBs  } 
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typedef  struct  MCB  far  *MCBPtr;  /*  FAR  pointer  to  an  MCB  */ 

#ifndef  MK_FP  /*  was  MK_FP  defined  already?  */ 
♦define  MK_FP (seg,  ofs)  ((void  far  *)  ((unsigned  long)  (seg) «16| (ofs) ) ) 
fendif 


/*********************★******************************************** 


***** 

*  Function  :FIRST_MCB  * 

** _ ** 

*  Description  ;  Returns  a  pointer  to  the  first  MCB.  * 


*  Input  parameters  :  none 

*  Return  value  :  Pointer  to  the  first  MCB 
******************************************************************* 

****/ 


MCBPtr  flrstjncbO 
{ 

union  REGS  regs; 
struct  SREGS  sregs; 


/*  stores  the  processor  registers  */ 
/*  stores  the  segment  registers  */ 


regs. h. ah  =  0x52;  /*  ftn.  no.:  get  address  of  the  DOS  info  block  */ 

lntdosx(  &regs,  &regs,  &sregs  );  /*  call  DOS  interrupt  0x21  */ 

/* —  ES:  (BX-4)  points  to  the  firs  MCB,  create  pointer - */ 


return  (  *( (MCBPtr  far  *)  MK_FP (  sregs. es-1,  regs.x.bx+12  ))  ); 

} 


/*********************************************************************** 

*  Function  :  D  U  M  P  * 

** _ ** 

*  Description  :  Outputs  hex  and  ASCII  dump  of  a  memory  range.  * 

*  Input  parameters  :  -  bptr  :  pointer  to  a  memory  area  * 

*  -  num  :  number  of  dump  lines  (each  16  bytes)  * 

*  Return  value  :  none  * 

***********************************************************************/ 


void  dump(  FB  bptr,  byte  num) 

{ 

FB  Iptr;  /*  running  pointer  for  printing  a  dump  line  */ 

unsigned  offset;  /*  offset  address  relative  to  BPTR  */ 

byte  i;  /*  loop  counter  */ 

print f("\nDUMP  |  0123456789ABCDEF  00  01  02  03  04  05  06  07  08"); 

printfC  09  OA  OB  OC  OD  OE  0F\n")  ; 

printf  (" - + - ") ; 

print f  (" - \n")  ; 

for  (offset =0;  num —  ;  offset  +=  16,  bptr  +=  16) 

{  /*  run  through  the  loop  NUM  times  */ 

printf ("%04x  |  ",  offset); 

for  (lptr=bptr,  i=16;  i —  ;  ++lptr)  /*  print  character  as  ASCII  */ 
printf ("%c",  (*lptr<32)  ?  '  '  :  *lptr); 
printf  ("  "); 

for  (lptr=bptr,  i=16;  i —  ;  )  /*  output  character  as  hex  */ 

printf  ("%02X  ",  *lptr++); 

printf ("\n") ;  /*  move  to  the  next  line  */ 

} 

} 


/*********************************************************************** 
*  Function  :TRACE_MCB  * 

** _ ** 
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*  Description  :  Traces  the  chain  of  MCB's.  * 

*  Input  parameters  :  none  * 

*  Return  value  :  none  * 

*************************************  ********^^***********************.**^ 


void  tracejmcbO 

{ 

static  char  fenv[] 


{  /*  first  environment  string 

•C,  'O',  'M',  'S',  'P',  'E',  'C, 


MCBPtr  curjncb; 
boolean  done; 
byte  nrjmcb, 
i; 

FB  Iptr;  /* 


/*  pointer  to  the  current  MCB 
/*  TRUE  if  the  last  MCB  was  found 
/*  number  of  the  current  MCB 
/*  loop  variable 
running  pointer  in  the  environment 


done  *  FALSE; 
nrjmcb  *  1; 

curjncb  *  first_mcb{); 
do 
{ 


/*  now  we  get  going 
/*  the  first  MCB  is  number  1 
/*  get  pointer  to  the  first  MCB 
/*  process  the  individual  MCB's 


if  (  cur_mcb->id_code  == 
done  =  TRUE; 
printfCMCB  number 
printf (-MCB  address 
printf ("Memory  addr. 
printf ("ID 
printf ("PSP  address 
printf ("Size 

cur_mcb->di stance 
printf ("Contents 


•Z'  )  /*  last  MCB  reached? 

/*  yes 

%d\n",  nrjncb++); 

%Fp\n",  curjncb); 

%Np:0000\n",  FP_SEG (cur_mcb) +1) ; 

%c\n",  curjncb“>id_code) ; 

%Fp\n",  (FB)  MK_FP (cur_mcb->psp,  0)  ); 

%u  paragraphs  (  %lu  bytes  )\n", 

,  (unsigned  long)  cur jncb->di stance  «  4) ; 
"); 


/* —  is  it  an  environment?  - 


*/ 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


.*/ 


for  (i=0,  lptr=*  (FB) curjncb+16; /*  compare  first  ENV  string  with  FENV 
(  i<sizeof  fenv  )  &&  (  *(lptr++)  fenv[i++]  )  ;  ) 


if  (  i  =*  sizeof  fenv  ) 

{ 

printf ("environmentXn") ; 
if  (  _osmajor  >=  3  ) 


/*  was  a  string  found? 
/*  yes,  it's  an  environment 


/*  DOS  version  3.0  or  higher? 
{  /*  yes,  get  program  name 

printf  ("Program  name  =  "); 
for  (  ;  !  (* (lptr++)=*0  &&  *lptr==0)  ;  ) 

;  /*  find  last  ENV  string 

if  (  * (Iptr  +=  3)  )  /*  is  there  a  program  name  here? 

{  /*  yes 

for  (  ;  *lptr  ;  )  /*  run  through  the  program  name 

printf (  "%c",  * (lptr++)  );  /*  output  a  character 

} 

else 

printf ("unknown") ; 
printf ("\n")  ; 


/*  no  program  name  was  found 
/*  move  to  the  next  line 


} 


*/ 


*/ 

*/ 

*/ 

*/ 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


/* —  output  the  environment  strings  - */ 

printf ("Environment  stringsXn") ; 

for  (lptr*(FB)  curjncb  +16;  *lptr  ;  ++lptr) 

{  /*  output  a  string  */ 

print  f("  "); 

for  (  ;  *lptr  ;  )  /*  run  through  the  string  to  a  NUL  character  */ 

printf (  "%c",  *(lptr++)  );  /*  output  a  character  */ 

printf ("\n") ;  /*  move  to  the  next  line  */ 

} 

} 

else  /*  no  envrionment  */ 

{ 
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/*-  is  it  a  PSP? - */ 

/* —  (introduced  with  the  command  INT  20  (Code-OxCD  0x20) )  - */ 

if  (*( (unsigned  far  *)  MK_FP (  cur_mcb->psp,  0  ))  “  0x20cd) 
printfCPSP  (with  subsequent  program)  Xn") ;  /*  yes  */ 


else  /*  the  command  INT  0x20  was  not  found  */ 

{ 

printf ("unidentifiable  (program  or  data)\n"); 

dump(  (FB)  cur_mcb  +  16,  5);  /*  dump  the  first  5x16  bytes  */ 

} 


print f ("-=-= 
printf  (••==*- 
if  (  !done  ) 

( 

cur_mcb  » 
getchO  ; 

} 


«««*«««  Please  press  a  key  ““Xn"); 

/*  another  MCB?  */ 
/*  yes,  set  pointer  to  the  next  MCB  */ 

(MCBPtr) 

MK_FP (  FP_SEG(cur_mcb)  +  cur_mcb->distance  +1,  0  ); 

/*  wait  for  a  key  */ 


} 

while  (  !done  );  /*  repeat  until  the  last  MCB  has  been  processed  */ 

} 


/********************************************************************** ^ 
/**  MAIN  PROGRAM  **/ 

/ ********************************************************************** y 

void  mainO 


{ 

printf ("XnMEMC  (c)  1988  by  Michael  TischerXnXn") ; 

tracejncbO;  /*  trace  the  chain  of  MCB's  */ 

] 
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6.10  DOS  Filters 

Filters  are  programs,  routines  or  utilities  which  accept  input  and  modify  the  data 
for  output.  Filters  do  the  same  on  the  operating  system  level:  characters  are  passed 
to  these  filters  as  input,  the  filters  modify  the  characters  then  send  the  modified 
characters  as  output.  This  manipulation  takes  many  forms.  Filters  can  sort  data, 
replace  certain  data  with  other  data,  encode  data  or  decode  data. 

DOS  has  three  basic  filters  available: 

FIND  searches  input  for  a  specified  set  of  characters 

SORT  arranges  text  or  data  in  order 

MORE  formats  text  display 

These  filters  perform  simple  redirection  of  standard  input/output.  They  read 
characters  from  the  standard  input  device,  manipulate  the  characters  as  needed,  then 
display  them  on  the  standard  output  device.  The  standard  input  device  under  DOS  is 
the  keyboard,  and  the  standard  output  device  is  the  monitor.  DOS  versions  of  2.0 
and  higher  allow  the  user  to  redirect  the  standard  input/output  to  files.  Therefore,  a 
filter  can  read  characters  from  the  keyboard  or  from  a  file,  depending  on  the  standard 
input  device  selected.  This  is  possible  by  using  a  filter  in  conjunction  with  one  of 
the  DOS  handle  functions  for  reading  and  writing.  DOS  offers  five  handles: 


0 

Standard  input  CON  (Keyboard) 

1 

Standard  output  CON  (Screen) 

2 

Standard  error  output  CON  (Screen) 

3 

Standard  serial  interface  AUX 

4 

Standard  printer  PRN 

If  the  user  calls  a  program  from  the  DOS  level,  the  <  character  redirects  input  and 
the  >  character  redirects  output.  In  the  following  example,  the  input  comes  from 
the  file  IN.TXT  instead  of  the  keyboard.  The  output  is  written  to  the  file 
OUT.TXT  instead  of  the  screen: 

sort  <in.txt  >out.txt 


SORT 


After  the  user  enters  the  above  command,  DOS  recognizes  that  a  program  named 
SORT  should  be  called.  Then  it  encounters  the  expression  <IN.TXT  which 
redirects  the  standard  input.  This  occurs  by  assigning  the  handle  0  (standard  input, 
which  formerly  pointed  to  the  keyboard)  to  the  file  IN.TXT.  The  expression 
>OUT.TXT  resets  handle  1  to  the  OUT.TXT  file  instead  of  the  screen.  The  affected 
handle  is  first  closed,  and  then  the  redirected  file  is  opened. 
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Once  the  command  processor  finishes  with  the  command  line  it  calls  the  SORT 
program  using  the  EXEC  function  (DOS  function  4BH).  Since  the  program  called 
with  the  EXEC  function  has  all  the  handles  of  the  calling  program  available,  the 
SORT  program  can  input/output  characters  to  handles  0  and  1.  Where  the 
characters  originate  is  unimportant  to  the  program. 

After  the  SORT  program  completes  its  work,  it  returns  control  to  the  command 
processor.  The  command  processor  resets  the  redirection  and  waits  for  further  input 
from  the  user. 


Pipes 


The  filter  principle  as  supported  by  DOS  becomes  especially  powerful  through 
pipes.  This  expression  comes  from  the  idea  of  a  pipeline  used  for  transporting  oil 
or  gas.  DOS  pipes  have  a  similar  function:  they  carry  characters  from  one  program 
to  another  and  permit  the  connection  of  various  programs  with  each  other. 

When  this  happens,  characters  output  from  one  program  to  the  standard  output 
device  can  be  read  by  another  program  from  the  standard  input  device.  As  in  the 
redirection  of  the  standard  input/output,  the  two  programs  do  not  notice  the 
pipelines.  The  difference  between  the  two  procedures  is  that  under  redirection  of  the 
standard  input/output  devices,  data  can  be  redirected  only  to  one  device  or  file, 
while  the  use  of  pipes  allows  data  transfer  to  another  program. 

Combined  filters 

Pipes  allow  the  user  to  connect  multiple  filters.  The  pipe  character  I  is  inserted 
between  the  programs  to  be  connected.  An  example  should  make  this  more 
understandable:  A  text  file  named  DEMO.TXT  is  sorted  and  then  displayed  on  the 
screen  in  page  format.  Even  though  this  task  appears  to  be  very  complicated  at 
first,  it  can  be  performed  easily  using  two  DOS  filters:  SORT  and  MORE.  SORT 
sorts  the  file  and  MORE  displays  the  file  on  the  screen  in  page  format 

The  question  is,  how  can  you  tell  the  command  processor  to  do  these  things?  First 
SORT  is  used.  This  filter  is  told  to  sort  the  file  DEMO.TXT.  The  redirection  of 
standard  input  can  be  used  as  illustrated  at  the  beginning  of  the  chapter: 

SORT  <DEMO.TXT 

After  the  user  enters  this  command,  SORT  sorts  the  file  DEMO.TXT  then 
displays  the  file  on  the  screen.  This  display  would  be  much  easier  to  read  in  page 
format.  Formatted  output  can  be  implemented  by  redirecting  the  output  from 
SORT  to  a  file  (for  example  TEMP.TXT)  and  displaying  this  file  using  the 
MORE  command.  The  following  sequence  of  commands  do  this: 

SORT  <DEMO.TXT  >TEMP.TXT 
MORE  <TEMP.TXT 
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You  can  use  a  pipe  to  connect  the  SORT  filter  and  the  MORE  filter,  saving  the 
user  typing  time.  The  following  command  line  sends  the  output  from  SORT 
directly  to  MORE  and  immediately  displays  the  sorted  file  in  page  format 

SORT  <DEMO.TXT  1  MORE 

Any  number  of  filters  can  be  connected  using  pipes.  DOS  always  executes  these 
pipelined  filters  from  left  to  right.  It  sends  the  output  from  the  first  program  as 
input  to  the  second  program,  the  second  program's  output  as  input  to  the  third 
program,  etc.  The  last  program  can  again  force  the  redirection  of  the  output  with 
the  >  character  so  that  the  final  result  of  the  whole  program  or  filter  chain  travels 
to  a  file  or  other  device  instead  of  the  screen. 

Note:  DOS  cannot  send  data  from  one  filter  directly  to  another  because  it 

would  have  to  execute  both  filters  simultaneously,  and  the  current 
version  of  DOS  doesn’t  have  multiprocessing  capabilities.  Instead, 
the  following  method  is  used.  The  input  calls  the  first  filter  and 
redirects  its  output  to  a  pipe  file.  After  the  first  filter  ends  its 
processing,  it  calls  the  second  filter  but  redirects  its  input  to  the  pipe 
file  to  read  in  the  output  from  the  first  filter.  This  principle  applies 
to  all  filters.  The  pipe  file  is  stored  in  the  current  working  directory. 

The  word  "dump"  is  a  computer  buzzword  for  a  way  to  display  the  contents  of  a 
file  in  ASCII  characters  and/or  hexadecimal  numbers.  The  DUMP  programs  below 
performs  this  task  as  a  filter.  As  the  contents  are  displayed  in  ASCII  format, 
DUMP  differentiates  between  normal  ASCII  characters  (letters,  numbers,  etc.)  and 
control  characters  such  as  carriage  return,  linefeed,  etc.  These  control  characters  are 
displayed  in  mnemonic  form  (e.g.,  <CR>  for  carriage  return  and  <LF>  for 
linefeed).  This  DUMP  filter  is  fairly  simple  in  structure,  yet  it  can  be  very  useful 
to  quickly  examine  a  file's  contents. 

The  structure  of  the  DUMP  program  is  typical  for  a  filter.  Since  DUMP  displays  a 
maximum  of  nine  ASCII  characters  and/or  hexadecimal  codes  per  line,  it  asks  for 
nine  characters  by  using  the  read  function  from  the  standard  input  device.  If  not 
enough  characters  are  available,  it  reads  what  characters  are  available.  DUMP 
places  these  characters  in  a  buffer,  then  converts  the  characters  into  ASCII 
characters  and  hex  codes.  This  buffer  will  accept  a  complete  line  of  78  characters. 
When  the  buffer  processing  finishes,  the  filter  uses  the  handle  to  write  to  the 
standard  output  device.  This  process  is  repeated  until  no  more  characters  can  be  read 
from  the  standard  input  device. 

The  following  programs  are  written  in  Pascal,  C  and  assembly  language.  Note  that 
there  isn't  a  BASIC  version.  The  reason  is  that  BASIC,  as  an  interpreted  language, 
is  unsuitable  for  developing  a  filter  which  can  be  called  from  the  DOS  level.  A 
BASIC  compiler  would  be  required  for  this  task. 
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Pascal  listing:  DUMPP.PAS 

I *★*★★***★**★* ********* *★★********★****★★**★★★★*★★*★** ***★★★******★*★ } 


{*  D  U  M  P  P  *} 

{* - *} 

{*  Task  :  a  Filter,  which  reads  in  characters  from  the  *} 

{*  Standard  input  device  and  outputs  than  *} 

{*  as  Hex  and  ASCII  dump  on  *} 

{*  the  Standard  output  device  *} 

^* - *} 

{*  Author  ;  MICHAEL  TISCHER  *} 

{*  developed  on  :  08/08/87  *} 

{*  last  Update  :  05/04/89  *} 

- *} 

{*  Info  :  This  program  can  only  be  called  from  the  *} 

{*  DOS  level  after  compiling  to  an  EXE  file  *} 

{*  with  TURBO  *} 


^ ***************************************************** *************** } 
program  DUMP; 


Uses  Dos; 

{$V-} 

const  NUL  =0; 

BEL  =  7; 

BS  =  8; 

TAB  =  9; 

LF  =  10; 

CR  =  13; 

EOF  =  26; 

ESC  =  27; 

type  SZText  *  string [3];  {  passe 

DumpBf  =  array [1.. 80]  of  char; 


{  Add  DOS  unit  } 
{  suppress  length  test  on  strings  } 


{  ASCII-Code  NUL-character  } 
{  ASCII-Code  Bell  character  } 
{  ASCII-Code  Backspace  } 
{  ASCII-Code  Tab  } 
{  ASCII-Code  Linefeed  } 
{  ASCII-Code  Carriage  Return  } 
{  ASCII-Code  End  of  File  } 
{  ASCII-Code  Escape  ] 


the  name  of  a  special  character  } 
{  accepts  the  output  Dump  } 


I  ******************************************************************** j 


{*  SZ  :  writes  the  name  of  a  control  character  into  a  Buffer  *} 
{*  Input  :  see  below  *} 
{*  Output  :  none  *} 
{*  Info  :  after  the  call  of  this  procedure  the  pointer  *} 
{*  which  was  passed,  points  behind  the  last  character  of  *} 
{*  the  control  character  name  in  the  Dunp-Buffer  *) 


I ********************************************************** **********j 


procedure  SZ (var  Buffer  :  DumpBf; 

Text  :  SZText; 

var  Pointer  :  integer) ; 


{  Text  entered  here  } 
{  Text  to  be  entered  } 
{  addr.  of  text  in  buffer  } 


var  Counter  :  integer; 
begin 

Buffer [Pointer]  {  leads  control  character  } 

for  Counter  :=  1  to  length (Text)  do  {  transfer  Text  to  Buffer  } 

Buffer [Pointer  +  Counter]  :*  Text[Counter]; 

Buffer [Pointer  +  Counter  +1]  :=•>';  {  terminates  control  char  } 

Pointer  ;=  Pointer  +  Counter  +2;  {  Pointer  to  next  character  } 

end; 


I  ******************************************************************** j 

{*  DODUMP  :  reads  characters  in  and  outputs  them  as  Dump  *} 
{*  Input  :  none  *} 
{*  Output  :  none  *} 
^********************************************************************^ 


procedure  DoDump; 
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Endc  : 
repeat 
Regs . ah 
Regs.bx 
Regs . cx 
Regs . ds 
Regs . dx 


false; 


$3F; 

0; 

9; 

seg (NewByte) ; 
of s (NewByte) ; 
MsDos  (  Regs  ) ; 
if  (Regs. ax  »  0)  then  Endc 
if  not (Endc)  then 
begin 

for  Counter  :=  1  to  30 
do  DumpBuf  [Counter]  := 
DumpBuf [31] 

Next A  :=  32 
for  Counter 
begin 
HexChr  := 


{  not  the  End  } 

{  Function  number  for  reading  handle  } 
{  the  Standard  input  device  is  handle  0  } 
(  read  in  9  characters  } 
(  Segment  address  of  the  buffer  } 
{  Offset  address  of  the  buffer  } 
(  Call  DOS-Interrupt  21 H  } 
:»=  true;  {  no  character  read?  } 

{  NO  } 

(  Fill  buffer  with  blanks  } 


#219;  (  Place  Separator  between  Hex  and  ASCII  } 

{  ASCI I -characters  follow  separator  } 
1  to  Regs. ax  do  (  start  processing  characters  } 

{  read  in  } 

ord  (NewByte [Counter] )  shr  4  +  48; 


if  (HexChr  >  57)  then  HexChr  :=  HexChr  +  7; 
DumpBuf [Counter  *  3  -  2]  :=  chr (HexChr); 
HexChr  :=  ord (NewByte [Counter] )  and  15  +  48; 
if  (HexChr  >  57)  then  HexChr  :*  HexChr  +  7; 
DumpBuf [Counter  *  3  -  1]  :=  chr (HexChr); 
case  ord (NewByte [Counter] )  of 


{  Hex  top  4  bits  } 
{  convert  char  } 
{  store  in  buffer  } 
(  Hex  bot.  4  bits  } 
{  convert  number  J 
{  store  in  buffer  } 
{  test  ASCII-Code  J 


NUL  :  SZ  (DumpBuf, 

•NUL', 

NextA) ; 

{  NUL-character 

BEL  :  SZ (DumpBuf, 

•BEL', 

NextA) ; 

{  Bell  character 

BS  :  SZ  (DumpBuf, 

•BS'  , 

NextA) ; 

{  Backspace 

TAB  :  SZ (DumpBuf, 

•TAB', 

NextA) ; 

{  Tab 

LF  :  SZ (DumpBuf, 

•LF'  , 

NextA) ; 

{  Linefeed 

CR  :  SZ  (DumpBuf, 

•CR'  , 

NextA) ; 

[  Carriage  Return 

EOF  :  SZ (DumpBuf, 

•EOF', 

NextA) ; 

{  End  of  File 

ESC  :  SZ  (DumpBuf, 

•ESC, 

NextA) ; 

{  Escape 

else 

begin 

{  normal  character 

DumpBuf [Next A] 

:=  NewByte [Counter] 

;  {  Store  ASCII-character 

Next A  ;=  succ(NextA) 

{  Set  pointer  to  next  character 

end 

end; 

end; 

DumpBuf [Next A]  :=  #219; 

{  Set  End  character 

DumpBuf [Next A+1 ]  := 

chr (CR) , 

;  (  Carriage-Return  followed  by  Line- 

DumpBuf [ Next A+  2 ]  ;  = 

chr (LF) , 

{  feed  to  buffer  end 

Regs. ah  :*  $40; 

{  Function 

number  for  writing  handle 

Regs.bx  :=  1; 

{  Standard 

output  device  is  handle  1 

Regs.cx  :=  NextA+2; 

{  Number  of  characters 

Regs.ds 
Regs . dx 
MsDos (  Regs  ) ; 
end; 

until  Endc; 
end; 


seg  (DumpBuf)  ; 
of s  (DumpBuf) ; 


[  Segment  address  of  the  buffer  } 
{  Offset  address  of  the  buffer  } 
(  Call  DOS-Interrupt  21 H  } 


{  repeat  until  no  more  characters  are  available  } 


{*  MAIN  PROGRAM  *} 

begin 

DoDump;  {  Output  Dun^*  J 

end. 
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C  listing:  DUMPC.C 


/*****★★★***★**★*★**★★**★★*******★**★****★★** ****★*******★***********/ 


/* 

/*- 

/* 

/* 

/* 

/* 

/*- 

/* 

/* 

/* 

/*- 

/* 

/* 

/* 

/* 

/*- 

/* 

/* 

/* 

/*★ 


Task 


Author 
developed  on 
last  Update 

(MICROSOFT  C) 
Creation 

Call 


D  U  M  P  C  */ 

- */ 

a  Filter  which  reads  in  characters  from  the  */ 
Standard  input  and  outputs  them  as 
Hex  and  ASCI I -Dump  on 
the  Standard  output  device 

MICHAEL  TISCHER 
08/14/87 
04/08/89 


:  MSC  DUMPC; 

LINK  DUMPC; 

:  DUMPC  [<Input]  [>Output] 


(BORLAND  TURBO  C) 

Creation  :  tcc  dumpc 

Call  :  DUMPC  [< Input]  [>Output] 


**************************************************************** 


*/ 

*/ 

*/ 

.*/ 

*/ 

*/ 

*/ 

.*/ 

*/ 

*/ 

*/ 

*/ 

.*/ 

*/ 

*/ 

*/ 

i*/ 


♦include  <stdio.h> 
♦include  <dos.h> 


/*  include  Header-files  */ 


♦define  byte  unsigned  char 


♦define 

NUL 

0 

/* 

Code 

of  NUL-character 

*/ 

♦define 

BEL 

7 

/* 

Code 

of  Bell 

*/ 

♦define 

BS 

8 

/* 

Code 

of  Backspace-key 

*/ 

♦define 

TAB 

9 

/* 

Code 

of  Tab-key 

*/ 

♦define 

LF 

10 

/* 

Code 

of  Linefeed 

*/ 

♦define 

CR 

13 

/* 

Code 

of  Return-key 

*/ 

♦define 

ESC 

27 

/* 

Code 

of  Escape-key 

*/ 

♦define 

tohex (c) 

(  ((c)  <10)  ?  ((c) 

1  48)  :  ((c)  + 

•A'  -  10)  ) 

f  ******************************************************************** / 

/*  GETSTDIN:  reads  a  certain  number  of  characters  from  the  Standard  */ 
/*  input  device  into  a  Buffer  */ 
/*  Input  :  see  below  */ 
/*  Output  :  Number  of  characters  read  */ 
/********************************************************************/ 


unsigned  int  GetStdIn (Buffer,  MaxChar) 

char  *Buffer;  /*  Pointer  in  Character-Vector,  which  accepts  data  */ 
unsigned  int  MaxChar;  /*  maximum  of  characters  to  be  read  in  */ 


{ 

union  REGS  Register;  /*  Register-Variable  for  Interrupt-Call  */ 

struct  SREGS  Segment;  /*  accepts  the  Segment  register  */ 


segread(& Segment) ; 

Register. h. ah  =  0x3F; 

Register. x.bx  =0; 

Register.x.cx  =  MaxChar, 

Register. x.dx  =  (unsigned  int)  Buffer;  / 
intdosx (^Register,  fiRegister,  sSegment) ; 


/*  read  content  of  Segment  register 
/*  Function  number  for 
/*  the  Standard  input  device  is  handle  0 
/*  Number  of  Bytes  to  be  read 
Offset  address  of  Buffer 
/*  Call  Interrupt  21H 


return (Register. X. ax) ; 

) 


/*  Number  of  Bytes  read  to  caller 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


/********************************************************************/ 
/*  STRAP  :  Attach  character  to  string  */ 

/*  Input  :  see  below  */ 

/*  Output  ;  Pointer  behind  the  last  added  character  */ 

^********************************************************************/ 


137 


6.  The  Disk  Operating  System 


PC  System  Programming 


char  *Strap (String,  Textpointer) 

char  *String,  /*  the  source  string  */ 

*Textpointer;  /*  Pointer  to  the  text  to  be  attached  */ 

{ 

while  (*Textpointer)  /*  repeat  until  'NO'  detected  */ 

*String++  =  *Text point er++;  /*  transmit  character  */ 

return (String) ;  /*  Pass  Pointer  to  calling  function  */ 

} 

/★****★★**★*★***★★★*★**★★****★***★*★★***★★**★★*★********★★****★★★★*★★/ 
/*  DODUMP  ;  reads  the  characters  in  and  outputs  them  as  Dump  */ 

/*  Input  :  none  */ 

/*  Output  :  none  */ 

/*****★**★★★★****★**★★★★***★★****★****★*★**★★★★**★★****************★*/ 


void  DoDumpO 

{ 

char  NewByte[9],  /*Accepts  the  characters  read  */ 

DumpBuf [ 80 ) ,  /*  accepts  a  line  of  DUMP  */ 

♦NextAscii;  /*  points  to  next  ASCII-character  in  the  buffer  */ 
byte  i,  /*  Loop  counter  */ 

Readbytes;  /*  Number  of  bytes  read  in  */ 

DumpBuf [30]  =  219;  /*  Set  separator  between  Hex  and  ASCII  */ 

while ( (Readbytes  =  GetStdIn (NewByte,  9))  !=  0) 

/*  as  long  as  characters  are  available  */ 

{ 

for  (i  =0;  i  <  30;  DumpBuf [i++]  =  '  '); 

/*  Fill  buffer  with  spaces  */ 
NextAscii  =  &DumpBuf [31] ;  /*  ASCII-characters  start  here  */ 

for  (i  =0;  i  <  Readbytes;  i++) 

/*  process  all  characters  read  in  */ 

{ 

DumpBuf [i*3]  =  tohex((byte)  NewByte[i]  »  4); 

/*  convert  Code  in  Hex  */ 
DumpBuf [i *3+1]  =  tohex((byte)  NewByte [1]  &  15); 

switch  (NewByte [i])  /*  evaluate  ASCII-Code  */ 

{ 

case  NUL  :  NextAscii  =  Strap  (NextAscii,  '‘<NUL>'*); 
break; 

case  BEL  :  NextAscii  =  Strap  (NextAscii,  ••<BEL>"); 
break; 

case  BS  :  NextAscii  =  Strap  (NextAscii,  ''<BS>’'); 
break; 

case  TAB  :  NextAscii  =  Strap  (NextAscii,  •'<TAB>"); 
break; 

case  LF  :  NextAscii  =  Strap  (NextAscii,  ''<LF>''); 
break; 

case  CR  ;  NextAscii  =  Strap  (NextAscii,  "<CR>'*); 
break; 

case  ESC  :  NextAscii  *  Strap  (NextAscii,  ••<ESC>") ; 
break; 

case  EOF  :  NextAscii  *  Strap  (NextAscii,  ‘'<EOF>"); 
break; 

default  :  *NextAscii++  =  NewByte [i]; 

} 

} 

*NextAscii  =  219;  /*  End  character  for  ASCII  representation  */ 

* (NextAscii +1)  =  'Nr';  /*  Carriage-Return  to  End  of  buffer  */ 

* (NextAscii +2)  =  '\0';  /*  NUL  converted  to  LF  on  output  */ 

puts (Dun¥>Buf ) ;  /*  Write  String  on  Standard  output  device  */ 

} 

I 


/**  MAIN  PROGRAM 


**/ 

**/ 

**/ 
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void  mln() 

I 

DoDumpO;  /*  Character  input/output  */ 

} 

Assembler  listing:  DUMP.ASM 


.★*★*★*★★★★**★***★★★★*★★★*★*★★*★**★★***★****★**★**★★**★★★**★★★★★*★★★★; 


•  * 
i 

DUMP 

★ 

•  ★ 

Task  :  A  Filter  which  reads  characters  from  the  Standard  input 

★ 

•  ★ 

and  outputs  them  as  Hex-  and  ASCII-Dump  on 

★ 

.  ★ 

the  Standard  output  device 

t  — 
•  ★ 

Author 

:  MICHAEL  TISCHER 

★ 

.  ★ 

developed  on 

:  08/01/87 

★ 

•  * 

• 

last  Update 

:  04/08/89 

★ 

_★ 

•  ★ 

assemble 

:  MASM  DUMPA; 

★ 

LINK  DUMPA; 

* 

•  ★ 
f 

.  ★ _ 

(important) _ 

EXE2BIN  DUMPA  DUMP.COM 

_★ 

•  ★ 

Call 

:  DUMP  [<Input]  [>Output] 

* 

.*★★★**★★★★*★*★★*★★*★**★*★**★*★*★★★★★**★★*★*★****★******★★★***★***★*★* 


;==  Constants 


NUL 

equ  0 

;ASCII-Code  NUL-Character 

BEL 

equ  7 

;ASCII-Code  Bell 

BS 

equ  8 

;ASCII-Code  Backspace 

TAB 

equ  9 

;ASCII-Code  Tabulator 

LF 

equ  10 

;ASCII-Code  Linefeed 

CR 

equ  13 

;ASCII-Code  Carriage  Return 

EOF 

equ  26 

;ASCII-Code  End  of  File 

ESC 

equ  27 

;ASCII-Code  Escape 

;==  Program  starts  here  ======== 

code 

segment  para  ' CODE ' 

; Definition  of  CODE- Segments 

org  lOOh 

assume  csicode,  dsicode 

1,  esicode,  ssicode 

dump 

label  near 

; —  Read  in  9  Bytes  from  Standard  input  device  - 

xor  bx, bx 

; Standard  input  has  the  handle  0 

mov  cx, 9 

;read  in  9  characters 

mov  dx, offset  newbyte 

; Address  of  the  buffer 

mov  ah,3Fh 

; Function  code  for  handle  reading 

int  21h 

;Call  DOS-Functlon 

or  ax, ax 

; characters  read  in? 

jne  dodump 

;YES  — >  process  line 

jmp  dumpend 

;N0  — >  DUMPEND 

dodump: 

mov  dx, ax 

/record  number  of  characters  read 

; —  Fill  output  buffer 

with  Spaces  - 

mov  cx, 15 

;15  Words  (30  Bytes) 

mov  ax, 2020h 

;ASCII-Code  of  "  “  to  AH  and  AL 

mov  di, offset  dunpbuf 

;the  Address  of  the  output  buffer 

cld 

/increment  on  String  commands 

rep  stosw 

/Fill  buffer  with  Spaces 
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; —  Construct  Output  Buffer  - 

mov  cx,cix  ;Get  number  of  characters  read  in 

mov  di, offset  dumpbuf+31  /Position  Ascii-Codes  in  the  buffer 


mov 

bx, offset  newbyte 

/Pointer  to  input  buffer 

mov 

si, offset  dunpbuf 

/Position  for  Hex-Codes  in  Buffer 

bytein: 

mov 

ah, [bx] 

/Read  in  Byte 

push 

si 

/store  SI  on  the  Stack 

mov 

si, offset  sotab 

/Address  of  special  character  table 

mov 

dx, offset  sotext-6 

/Address  of  special  character  text 

sotest : 

add 

dx,6 

/next  entry  in  special  text 

lodsb 

/Load  code  from  special  char  table 

citp 

al,255 

/Reached  end  of  table? 

je 

noso 

/YES  — >  no  special  character 

cmp 

ah,al 

/do  codes  agree? 

jne 

sotest 

/NO  — >  test  next  table  element 

Code  was  a  special 

character  - 

push 

cx 

/Store  Counter 

mov 

si,  dx 

/copy  DX  to  SI 

lodsb 

/read  number  of  char  control  codes 

mov 

cl,  al 

/transfer  number  of  characters  to  CL 

rep 

movsb 

/copy  designation  into  buffer 

pop 

cx 

/get  counter 

pop 

si 

/return  SI  from  Stack 

mov 

al,  ah 

/copy  character  to  AL 

jmp 

short  hex 

/calculate  Hex-Code 

noso: 

pop 

si 

/return  SI  from  Stack 

mov 

al,ah 

/copy  character  to  AL 

stosb 

/store  in  buffer 

hex: 

mov 

al,  ah 

/Code  of  character  to  AL 

and 

ah, 1111b 

/mask  upper  4  Bit  in  AH 

shr 

al,l 

/shift  AL  right  4  Bits 

shr 

al,l 

shr 

al,l 

shr 

al,l 

or 

ax,3030h 

/convert  AH  and  AL  into  ASCI I -Codes 

cmp 

al,"9" 

/ is  AL  a  letter  ? 

jbe 

nobal 

/NO  — >  no  correction 

add 

al,"A"-"l"-9 

/correct  AL 

nobal : 

cmp 

ah,  ••9" 

/is  AH  a  letter  ? 

jbe 

hexout 

/NO  — >  no  correction 

add 

ah,"A"-“l"-9 

/correct  AH 

hexout : 

mov 

[si ] , ax 

/store  Hex-Code  in  buffer 

add 

si,  3 

/point  to  next  Position 

inc 

bx 

/set  pointer  to  next  Byte 

loop  bytein 

/process  next  Byte 

mov 

al,219 

/ set  separator 

stosb 

mov 

ax, LF  shl  8  +  CR 

/CR  and  LF  terminate  buffer 

stosw  /write  in  buffer 

; —  Send  Dump  to  the  Standard  output  device 


mov 

bx,  1 

/Standard  output  is  handle  1 

mov 

cx,  di 

/determine  number  of  characters 

sub 

cx, offset 

dumpbuf 

/ transmitted 

mov 

dx, offset 

dumpbuf 

/Address  of  buffer 

mov 

ah, 40h 

/Function  code  for  handle 

int 

21h 

/call  DOS-f unction 

jmp 

dump 

/read  in  next  9  Bytes 
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dumpend  label  near 

mov  ax, 4C00h 
int  21h 

/Function  number  for  ending  program 
;end  program  with  End  code 

newbyte  db  9  dup  (?)  ;the  9  Bytes  read  in 


dumpbuf 

db  30  dup  (?),  219 
db  49  dup  (?) 

;the  output  buffer 

sotab 

db  NUL,BEL,BS,TAB 
db  LF,CR,EOF,ESC 
db  255 

/Table  of  control  characters 

sotext 

equ  this  byte 

/Text  of  special  characters 

db  5,-<NUL>“ 

/NUL 

db  5,''<BEL>- 

/Bell 

db  4,''<BS>  •' 

/ Backspace 

db  5,”<TAB>- 

/Tabulator 

db  4,’‘<LF>  •• 

/Linefeed 

db  4,-<CR>  •• 

/Carriage-Return 

db  5,“<E0F>" 

/End  of  File 

db  5,-<ESC>'' 

/  Escape 

$ cna 

code 

ends 

/End  of  CODE-Segment 

end  dump 
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6.11  <Ctrl><Break>  and  Critical  Error  Interrupts 

DOS  offers  two  ways  of  stopping  a  program  during  execution.  These  situations 
occur  when  the  user  hits  <Ctrl><Break>  (<Ctrl><C>),  or  when  a  critical  error 
occurs  during  access  to  an  external  device  (i.e.,  printer,  hard  disk,  disk  drive,  etc.). 
Although  the  key  combination  varies  with  the  PC  configuration,  we’ll  use 
<Ctrl><Break>  consistently  in  this  section. 

<Ctrl><Break> 

Pressing  <Ctrl><Break>  to  stop  a  program  during  execution  can  have  some 
serious  consequences.  After  the  user  presses  this  key  combination,  DOS  abruptly 
takes  control  from  the  program  without  allowing  the  program  to  perform  any 
"housekeeping”  that  may  be  needed.  Files  are  not  closed  properly,  diverted  interrupt 
vectors  are  not  reset,  and  allocated  memory  is  not  released.  The  final  result  can 
range  from  a  loss  of  data  to  a  system  crash. 

In  order  to  prevent  this,  DOS  calls  interrupt  23H.  This  interrupt  is  also  known  as 
the  <Ctrl><Break>  interrupt.  When  a  program  is  started,  this  interrupt  points  to  a 
routine  which  brings  about  the  end  of  the  program.  But  a  program  is  free  to  select 
a  routine  of  its  own,  thus  maintaining  control  of  what  occurs  when  the  user 
presses  <Ctrl><Break>. 

However,  the  interrupt  routine  doesn't  execute  immediately.  The  break  flag 
controls  when  the  interrupt  routine  occurs.  This  flag  can  be  set  at  the  DOS  prompt 
using  the  BREAK  (ON/OFF)  command  from  DOS,  or  with  the  help  of  DOS 
function  33H,  sub-function  1.  If  the  break  flag  is  on,  every  time  a  function  of 
DOS  interrupt  21H  is  called,  the  keyboard  buffer  will  be  checked  to  see  if  either 
<Ctrl><Break>  or  <Ctrl><C>  has  b^n  pressed.  If  the  break  flag  is  off,  this  check 
will  be  made  only  when  calling  the  DOS  functions  that  access  the  standard  input 
and  output  devices. 

If  this  test  finds  the  appropriate  key  combination,  the  processor  registers  are  loaded 
with  the  values  contained  in  the  DOS  function  to  be  executed.  Only  after  this  is 
interrupt  23H  called. 

If  a  program  directs  this  interrupt  to  a  routine  of  its  own,  there  are  several  ways  to 
react.  For  example,  the  program  could  open  a  window  on  the  screen  which  asks  if 
the  user  would  like  to  end  the  program.  It  can  also  decide  for  itself  whether  or  not 
the  program  should  end. 

Maintenance 

If  the  program  chooses  to  halt  execution,  some  form  of  clean-up  routine  should 
follow.  A  routine  of  this  type  closes  all  open  files,  resets  any  changed  interrupt 
pointers,  and  releases  any  allocated  memory.  After  this,  function  4CH  can  end  the 
program  without  returning  control  to  the  interrupt  23H  caller. 
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If  <Ctrl><Break>  is  to  be  ignored,  then  the  IRET  assembly  language  instruction 
must  return  control  to  DOS.  The  program  must  then  ensure  that  all  processor 
registers  contain  the  same  values  they  had  when  interrupt  23H  was  invoked. 
Otherwise,  the  DOS  function  that  was  originally  called  cannot  be  completed 
without  OTor. 

Both  ways  of  handling  this  situation  will  be  demonstrated  in  an  example  at  the  end 
of  this  section. 

Critical  error  interrupt 

Unlike  the  <Ctrl><Break>  interrupt,  the  critical  error  interrupt  call  is  rarely  a 
reaction  to  something  the  user  does  intentionally.  It  is  usually  a  reaction  to  an 
error  that  occurs  when  accessing  an  external  device,  such  as  a  printer,  disk  drive,  or 
hard  disk.  While  the  user  can  correct  the  error  in  many  cases  (e.g.,  printer  not 
turned  on),  other  errors  can  be  caused  by  hardware  failures  that  require  repairs  (e.g„ 
read  otqt  while  accessing  hard  disk). 

To  make  allowances  for  the  various  kinds  of  errors,  the  critical  error  interrupt 
(interrupt  24H)  normally  points  to  a  DOS  routine  that  displays  the  following  or  a 
similar  message  on  the  screen  and  waits  for  input  from  the  user: 

(A)bort  (R)etry  (I)gnore  (F)ail 

This  clears  the  screen  of  the  program  currently  under  execution.  In  addition,  this 
interrupt  doesn’t  provide  a  ’’clean"  program  end.  Like  <CtrlxBreak>,  the  program 
is  in  a  situation  where  files  are  not  properly  closed,  allocated  memory  is  not 
released,  etc. 

Installing  an  interrupt  handler  in  a  program  to  replace  the  DOS  handler  can  help 
here,  too.  DOS  enlists  the  help  of  a  processor  register  to  pass  this  handler  various 
information  when  it  is  called.  This  helps  the  interrupt  handler  locate  the  source  of 
the  error.  Bit  7  in  the  AH  register  indicates  either  a  floppy  or  hard  disk  access  error 
(bit  7  ofO,  or  some  other  error  (bit  7  on).  In  addition,  the  BP:SI  register  pair 
points  to  the  head  of  the  device  driver  that  was  being  called  when  the  error 
appeared.  A  detailed  error  code  is  contained  in  the  lower  8  bits  of  the  DI  register, 
and  the  contents  of  the  upper  8  bits  are  undefined.  This  returns  the  following  error 
codes: 
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Error  Codes  Passed  to  the  Critical  Error  Handler 


Code 

Meaning 

OOh 

Disk  is  write  protected 

Olh 

Access  to  an  unknown  device 

02h 

Drive  not  ready 

03h 

Unknown  comrnand 

04h 

CRC  error 

05h 

Wrong  data  length 

06h 

Seek  error 

07h 

Unknown  device  type 

08h 

Sector  not  found 

09h 

Printer  out  of  paper 

OAh 

Write  error 

OBh 

Read  error 

OCh 

General  error 

When  called,  the  critical  error  handler  can  respond  by  opening  a  window  on  the 
screen  that  asks  the  user  to  decide  to  ignore  the  error,  retry  the  access,  or  abort  the 
program.  The  latter  option  can  only  instruct  the  interrupt  to  call  DOS  functions 
OlH  to  OCH.  This  means  that  the  program  ends  abruptly,  similar  to  pressing 
<Ctrl><Break>.  While  it  is  true  that  calling  other  DOS  functions  within  the 
handler  causes  no  errors  in  itself,  the  return  to  DOS  causes  a  system  crash.  Such 
handlers  are  also  not  allowed  to  end  a  program  through  the  use  of  DOS  function 
4CH.  Instead  the  handler  must  return  to  its  caller  with  the  help  of  the  IRET 
command.  With  that,  DOS  expects  a  code  in  the  AL  register  that  will  show  it  how 
to  react  to  the  error.  It  interprets  the  contents  of  the  AL  register  as  follows: 

Output  Codes  of  a  Critical  Error  Handler 


Code 

Meaning 

OOh 

Ignore  the  error 

Olh 

Retry  the  operation 

02h 

End  program  with  Interrupt  23h 

03h 

End  function  called  with  an 

error 

(DOS  3.0  up  only) 

The  last  output  code  in  the  above  list  represents  the  most  sensible  reaction  to  an 
error  that  can't  be  fixed  by  repeating  the  operation  (as  in  the  example  where  the 
printer  needs  to  be  turned  on).  The  receipt  of  this  code  invokes  the  normal  ending 
of  the  function  call  in  which  the  error  occurred.  The  function  then  sets  the  carry 
flag  to  signal  the  error.  While  this  makes  a  "critical"  error  and  a  "normal"  error 
indistinguishable  to  the  program,  it's  possible  to  tell  them  apart  by  setting  a  flag 
within  the  critical  error  handler. 

•  1fk**-k**-k**-k-k*-k-kifk-kifk1fk1t1fk1t1fk1t*-k-k*-kit*1t**1fk*-k1t  *************************** 

;*  C  E  H  A  N  D  *; 


Description  :  Forms  the  basic  structure  of  an  assembler 
program,  in  which  the  DOS  Ctrl-Break  and 
Critical  Error  Interrupt  are  captured 


Author  :  MICHAEL  TISCHER 

developed  on  ;  9/5/1988 

last  update  :  4/8/1989 
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call  :  CE  HAND 


(please  leave  the  disk  drive  open  so  that  a 
Critical  Error  occurs.) 


.**********************************************************************; 
f  > 

f  —  St  d  CJC 
Stack 

segment  para  stack 

/definition  of  the  stack  segment 

dw 

256  dup  (?) 

/the  stack  is  256  words 

stack 

ends 

/end  of  the  stack  segment 

/ —  data  ■ 
data 

segment  para  'DATA' 

/definition  of  the  data  segment 

cr_err 

db 

0 

/goes  to  1,  if  a  critical  error  occurs 
/during  access  to  a  peripheral  device 
/ (floppy,  hard  disk,  or  printer) 

cr_typ 

db 

0 

/error  number  of  the  critical  error 

cr_mes 

db 

"Critical  error! 

(A)bort  or  (R)etry:  $" 

next_llne 

db 

13,10,"$" 

end_mes 

db 

"Program  ended  normally. $" 

brk_mes 

db 

"Program  aborted. 

$" 

dat_nam 

db 

"A: TEST. DAT",  0 

/name  of  the  test  file 

data 

;==  code  = 

ends 

/end  of  the  data  segment 

code  segment  para  'CODE'  ;definition  of  the  CODE  segment 

assume  csrcode,  dsrdata,  ss: stack 
start  proc  far 

; —  install  both  Interrupt  Handlers  - 

push  cs  ;put  CS  on  the  stack 

pop  ds  ;and  return  as  DS 

mov  ax,2523h  ;fct.no.:  set  Ctrl-Break  Handler 

mov  dx, offset  cbreak  ;DS:DX  now  contains  the  address  of  H. 

int  21h  ;call  DOS  Interrupt 

mov  al,24h  ;now  set  Interrupt  24h 

mov  dx, offset  cerror  ;DS:DX  contains  the  address  of  the  new  H. 
int  21h  ;call  DOS  Interrupt 

mov  ax, data  ;load  segment  address  of  the  data  segment  in 

mov  ds,ax  ;in  the  DS  register 

; —  you  can  add  your  program  here  - 


; —  for  a  demonstration,  try  to  open  a  file  - 

; —  on  the  opened  disk  drive  - 

dat_open:  mov  ah, 3dh  ; function  number:  open  file 

mov  al,0  /file  mode:  read  only 

mov  dx, offset  dat_nam  ;DS:DX  =  addresse  of  the  filename 
int  21h  /call  DOS  Interrupt  21h 

jnc  exit  /no  error?  NO  — >  END 

cmp  cr_err, 0  / critical  error? 

je  exit  /NO  — >  END 

call  crit_err  /a  critical  error  occured 

jmp  dat_open  /CRIT_ERR  returns  only  if  the  operation 

/should  be  retried 
/ (IGNORE  is  not  possible) 

/ —  the  handler  must  not  be  re-installed  before  the  end  - 

/ —  of  the  program,  since  this  is  done  by  DOS  - 

exit:  mov  ah, 9  /function  number:  pass  string 

mov  dx, offset  end_mes  /DS:DX  =  address  of  the  message 
int  21h  /call  DOS  Interrupt 

mov  ax, 4C00h  /function  no.:  end  program  (ERRCODE=0) 

int  21h  /call  DOS  Interrupt  and  end  the  program 

/with  it 

start  endp 

/ —  CRIT_ERR:  called  within  the  program  after  discovery  of  a  - 

/ —  critical  error  - 

crit_err  proc  near 

/ —  output  message  and  ask  for  user  input  - 

ask:  mov  ah, 9  /function  number:  output  string 

mov  dx, offset  cr_mes  /DS:DX  =  address  of  the  message 
int  21h  /call  DOS  Interrupt 
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mov 

ah,l 

/function  number:  input  character 

int 

21h 

•call  DOS  Interrupt 

push  ax 

•note  the  input 

mov 

ah,  9 

/function  number:  output  string 

mov 

dx, offset 

next  line 

/DS:DX  *  address  of  the  message 

int 

21h 

•call  DOS  Interrupt 

/ 

interpret  the  user's 

input  - 

pop 

ax 

•retrieve  the  input 

cmp 

al,  "A" 

•abort? 

je 

end_up 

/go  to  "clean-up"  procedure 

cmp 

al, "a" 

•abort? 

je 

end_up 

/go  to  "clean-up"  procedure 

cmp 

al, "r" 

•retry? 

je 

crend 

•go  to  end  of  procedure 

cmp 

al, "R" 

•retry? 

jne 

ask 

•no,  ask  again 

crend: 

ret 

/return  to  caller 

crit  err 

endp 

/—  END_ 

UP:  executes  a  " 

clean" 

ending  - 

end_up 

proc 

near 

f 

all  opened 

files 

can 

be  closed  and  the  system  memory  - 

/ 

allocated  by  the 

pro( 

jram  can  be  freed  here  - 

mov 

ah,  9 

function  number;  output  string 

mov 

dx, offset 

brk  mes 

DS;DX  =  address  of  the  message 

int 

21h 

call  DOS  Interrupt 

mov 

ax, 4C00h 

end  the  program  normally  with  the 

int 

21h 

4Ch  function 

end_up 

endp 

; —  CBREAK:  the  new  Ctrl -Break  Handler  - 

cbreak  proc  far 

; —  all  registers  altered  within  this  routine  (excluding  - 

; —  the  Flag  Register)  have  to  be  secured  on  the  stack  - 

push  ds 

mov  ax, data  ;load  the  segment  address  of  the 

mov  ds,ax  ;data  segment  in  the  DS-Register 

; —  for  example,  you  can  open  a  window  here  in  which  the  - 

; —  user  is  asked  if  he  really  wants  to  end  the  program  - 


go_on: 


jmp  go_on  /don't  end  program 

; —  if  the  user  decides  to  end  the  program,  a  routine  with  - 
; —  which  the  program  can  be  ended  can  be  started  here 
jmp  end_up  /prepare  termination  of  the  program 

; —  the  program  should  not  be  aborted,  continue  normal  - 

; —  execution  - 

pop  ds  /restore  saved  register 

iret  /back  to  DOS,  where  the  interrupted 

/function  is  continued  normally 


cbreak  endp 

/ —  CERROR:  the  new  Critical  Error  Handler  - 

cerror  proc  far 

/ —  each  of  the  registers  (SS,  SP,  DX,  ES,  DX,  CX  und  BX)  - 

/ —  that  was  altered  within  this  routine  must  be  saved  - 

/ —  on  the  stack  - 

sti  /allow  interrupts  again 

push  ds 


146 


Abacus 


6J1  <Ctrl>  <Break>  and  Critical  Error  Interrupts 


mov 

ax, data 

;load  segment  address  of  the  ( 

mov 

ds,  ax 

;in  the  DS-Register 

mov 

cr  err,l 

/point  to  critical  error 

mov 

ax,  di 

/error  number  to  AX 

mov 

cr  typ,al 

/note  error  number 

mov 

al,3 

/end  function  call  with  error 

pop 

ds 

/fetch  DS  again 

Iret 

cerror 

endp 

code 

ends 

/end  of  the  code  segment 

end 

start 

/start  program  execution  with 
/the  START  procedure 
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6.12  DOS  Device  Drivers 

A  device  driver  is  the  part  of  the  operating  system  responsible  for  the  control  of, 
and  the  communication  with,  the  hardware.  It  represents  the  lowest  level  of  an 
operating  system,  and  permits  all  other  levels  to  work  independent  of  hardware. 
When  adjuring  an  operating  system  to  various  computers,  this  is  an  advantage. 
The  entire  operating  system  doesn't  have  to  be  changed,  only  the  various  device 
drivers. 

In  earlier  operating  systems,  device  drivers  resided  in  the  operating  system  code. 
This  meant  that  changes  or  upgrades  of  these  routines  to  match  new  hardware  were 
very  difficult,  if  not  impossible.  DOS  Version  2.0  introduced  a  flexible  concept  of 
device  drivers.  This  makes  it  possible  for  the  us&r  to  adapt  even  the  most  exotic 
PC  clone  to  DOS. 

Custom  drivers 

Since  communication  between  DOS  and  a  device  driver  is  based  on  relatively 
simple  function  calls  and  data  structures,  the  assembly  language  programmer  can 
develop  a  device  driver  to  adapt  DOS  to  any  device.  Unfortunately,  device  drivers 
cannot  be  programmed  in  a  higher  level  language. 

When  developing  the  code  for  a  driver,  the  same  rules  are  observed  as  for 
developing  a  COM  program  (no  direct  segment  access).  The  difference  is  that  a 
device  driver  starts  at  offset  address  OH,  and  not  at  lOOH.  The  end  of  this  section 
explains  the  assembly  language  implementation  in  detail. 


Drivers 


During  the  DOS  boot  process,  the  drivers  NUL,  CON,  AUX,  PRN  and  the  drivers 
for  the  disk  drives  and  hard  drive  (if  needed)  are  loaded  and  installed.  They  are 
arranged  sequentially  in  memory  and  connected  to  each  other.  If  the  user  wants  to 
install  his  own  driver,  he  has  to  inform  DOS  using  the  CONFIG.SYS  file.  This 
text  file  contains  the  information  which  DOS  requires  for  configuring  the  system. 
Contents  of  the  CONFIG.SYS  file  are  read  and  evaluated  during  the  boot  process 
after  linking  the  standard  drivers.  If  DOS  finds  the  DE VICE=  command,  it  knows 
that  a  new  driver  should  be  included.  The  name  of  the  driver  and  perhaps  a  device 
and  path  designation  are  indicated  after  the  equal  sign. 

ANSI. SYS 

The  following  command  sequence  includes  the  ANSI.SYS  driver,  which  is 
supplied  with  DOS.  This  driver  makes  enhanced  character  output  and  keyboard 
functions  available: 

DEVICE=ANSI.SYS 
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The  new  driver  is  added  to  the  chain  immediately  following  the  NUL  device  driver 
(the  first  driver  in  the  chain).  The  ANSI.SYS  driver  replaces  the  default  CON 
driver.  To  ensure  that  all  function  calls  for  monitor  or  keyboard  communication 
operate  through  ANSI.SYS,  the  ANSI.SYS  driver  is  placed  first  in  the  device 
group,  and  the  CON  driver  is  moved  farther  down  the  chain  of  devices.  Since  the 
operating  system  moves  from  link  to  link  during  the  search,  it  finds  the  new  CON 
driver  (ANSI.SYS)  first  and  uses  it.  Therefore,  the  system  ignores  the  old  CON 
driver  as  seen  in  the  illustration  below: 


<D 

fi) 

» 

3 

(Q 

3 

<D 

3 

o 

Q. 

Q. 

<D 

(0 


T 


The  driver  chain 


ASSIGN 

Not  all  drivers  can  be  replaced  with  new  ones.  The  NUL  driver  is  always  the  first 
driver  in  the  chain.  If  you  add  a  new  NUL  driver,  the  system  ignores  the  new  driver 
and  continues  accessing  the  original  NUL  driver.  This  also  applies  to  the  drivers 
for  floppy  disk  drives  and  hard  drives.  The  reason  for  this  is  that  disk  drives  have 
drive  specifiers  instead  of  names  such  as  CON  (e.g..  A:).  A  new  disk  drive  can  be 
added  to  the  system,  but  since  DOS  may  assign  it  the  name  D:,  it  may  not  be 
addressed  by  all  programs  which  want  to  access  device  A:.  This  problem  can  be 
avoided  by  redirecting  all  device  accesses  using  DOS's  ASSIGN  command.  You 
can  make  the  ASSIGN  command  part  of  the  AUTOEXEC.BAT  file.  It  executes 
after  adding  drivers  and  executing  the  CONFIG.SYS  file.  To  redirect  all  accesses 
from  drive  A:  (the  first  disk  drive)  to  device  D:  (in  this  case,  a  new  driver  for  a  new 
disk  drive),  the  AUTOEXEC.BAT  file  must  contain  the  following  command 
sequence: 
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ASSIGN  A=D 

The  drivers  for  mass  storage  devices  and  the  drivers  such  as  PRN  are  handled 
differently.  DOS  has  two  kinds  of  device  drivers: 

•  Character  device  drivers 

•  Block  device  drivers 

CharactCT  device  drivers  communicate  with  the  keyboard,  screen,  printer  and  other 
hardware  on  a  character  by  character  (byte  by  byte)  basis.  Block  device  drivers  can 
transmit  an  entire  series  of  charact^  during  each  function  call  (disks,  hard  disks, 
etc.).  The  two  driver  groups  differ  somewhat  through  the  ways  each  supports 
different  functions. 


6.12.1  Character  Device  Drivers 

Let's  start  with  character  device  drivers  because  their  structure  is  simpler  than  block 
device  drivers.  Character  device  drivers  transmit  one  byte  for  every  function  call. 
They  communicate  with  devices  such  as  the  keyboard,  display,  printer  and  modem. 
A  device  driver  can  service  only  one  device.  Therefore,  individual  drivers  for 
keyboard,  display,  printer,  etc.,  exist  in  DOS  after  booting. 

Character  devices  can  operate  in  either  cooked  mode  or  raw  mode. 

Cooked  mode 

In  cooked  mode,  the  device  driver  reads  characters  from  the  device  and  performs  a 
test  for  certain  control  characters.  DOS  then  passes  the  character  to  an  internal 
buffer.  DOS  also  checks  to  determine  whether  any  <Enter>,  <Ctrl><P>, 
<Ctrl><S>  or  <Ctrl><C>  characters  exist.  If  the  system  detects  the  <Enter> 
character,  it  ignores  any  further  input  from  the  device  driver,  even  if  the  specified 
number  of  characters  has  not  yet  been  read.  Then  the  characters  read  are  copied  from 
the  internal  buffer  to  the  buffer  of  the  calling  program.  If  characters  are  output  in 
cooked  mode,  DOS  tests  for  <Ctrl><C>  or  <Ctrl><Break>.  If  one  of  these 
combinations  is  detected,  the  currently  running  program  stops.  Pressing 
<Ctrl><S>  temporarily  stops  the  program  until  the  user  presses  any  other  key. 
<Ctrl><P>  redirects  the  output  from  the  screen  to  the  printer  (PRN).  Pressing 
<CtrlxP>  a  second  time  redirects  the  output  from  the  printer  back  to  the  screen. 

Raw  mode 

In  raw  mode,  the  device  driver  reads  all  characters  without  testing.  If  a  program 
wants  to  read  in  10  characters,  it  reads  exactly  10  characters,  even  if  the  user 
presses  the  <Enter>  key  as  the  second  character  of  the  string.  Raw  mode  transmits 
the  characters  direct  to  the  calling  program's  buffer,  instead  of  using  an  internal 
DOS  buffer.  During  character  output,  raw  mode  doesn't  test  for  <Ctrl><C>  or 
<Ctrl><Break>. 
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DOS  function  44H  of  interrupt  21H  deHnes  the  mode  of  the  character  device  driver 
(see  the  end  of  this  section  for  a  detailed  description  of  this  interrupt). 


6.12.2  Block  Device  Drivers 

A  block  device  driver  normally  communicates  with  mass  storage  devices  such  as 
floppy  or  hard  disks,  or  high  speed  cassette  tapes.  For  this  reason,  they 
simultaneously  transmit  a  number  of  characters  which  are  designated  as  a  block.  In 
some  cases,  a  single  call  to  a  function  transmits  several  blocks  of  data.  The  sizes 
of  these  blocks  can  differ  from  one  mass  storage  device  to  another,  as  well  as 
within  one  particular  mass  stwage  device. 

How  block  device  drivers  work 

Unlike  character  device  drivers,  a  block  device  driver  can  control  several  devices  at 
the  same  time.  You  can  even  divide  one  device  into  several  logical  units.  For 
example,  a  40  megabyte  hard  disk  can  be  divided  into  two  20  megabyte  hard  disks 
with  the  names  C  and  D.  These  logical  devices  have  single-letter  specifiers  instead 
of  device  names  or  filenames.  The  device  designation  depends  on  its  position  in  the 
chain  of  device  drivers.  If  a  device  driver  supports  several  logical  devices,  single 
letters  can  be  used  as  specifiers  in  sequential  order.  This  is  why  the  example  above 
lists  two  logical  drives  named  C  and  D  instead  of  C  and  F. 

Every  one  of  these  devices  must  have  a  file  allocation  table  (FAT)  and  a  root 
directory.  Block  device  drivers  make  no  distinction  between  cooked  and  raw  modes. 
They  always  read  and  write  the  exact  number  of  blocks  unless  an  errOT  is  detected. 

Access 


There  are  several  ways  to  access  a  device  driver.  Character  device  drivers  are 
accessed  using  the  normal  FCB  or  handle  functions  by  simply  indicating  the  name 
of  a  driver  (e.g.,  CON:  instead  of  a  filename).  A  block  device  driver  is  accessed 
using  the  normal  DOS  functions  (file,  directory,  etc.)  by  using  the  drive  designator 
assigned  by  DOS  during  the  boot  process. 

Functions  IH  through  CH  of  interrupt  21H  invoke  read  and  write  operations  in  a 
device  driver.  Two  other  options  exist  for  accessing  device  drivers.  These  will  be 
discussed  shortly. 


6.12.3  Structure  of  a  Device  Driver 

Even  though  the  two  types  of  device  drivers  differ  in  some  important  details,  they 
do  have  similar  structures.  Each  has  a  device  header,  a  strategy  routine  and  an 
interrupt  routine  (a  different  kind  of  interrupt  from  the  ones  you've  read  about  up 
until  now). 
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Device  header 

The  device  header  appears  at  the  beginning  of  each  device  driver  and  contains 
information  needed  by  DOS  for  implementing  the  driver. 

The  first  two  fields  are  the  link  to  the  next  driver  (offset  and  segment  address)  in 
the  chain  of  device  drivers.  The  memory  locations  required  for  these  link  fields 
must  be  reserved  by  the  programmer,  but  DOS  fills  in  when  the  driver  is  installed 
in  the  system.  The  next  field  of  the  device  header  is  the  attribute  word.  The 
attribute  word  describes  the  device  driver  and  tells  DOS,  among  other  things,  if  it 
is  a  block  or  character  device  driver. 


+  02H 

Seament  address  of  next  driver  (1  word) 

-f-  04H 

Device  attribute  (1  word) 

+  0  6H 

Offset  address  of  strateav  routine  (1  word) 

+  OSH 

Offset  address  of  interrupt  routine  (1  word) 

+  OAH 

Driver  name  from  character  driver  (8  bytes) 

or  number  of  devices  used  by  block  driver 

RAM 


0000 


Device  driver  header 
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Structure  of  the  device  attribute 

Only  bits  11  through  15  are  used  by  a  block  driver.  The  lOCTL  bit  tells  DOS  if 
this  driver  supports  the  lOCTL  function  of  DOS.  The  end  of  this  chapter  and  the 
descriptions  of  functions  3  and  12  describe  this  function  in  greater  detail.  Bit  11 
first  appears  in  DOS  Version  3  and  should  be  0  in  earlier  versions.  A  block  driver 
indicates  whether  a  medium  change  is  recognized  on  the  device  supported  (e.g.,  a 
floppy  disk  drive).  If  the  bit  is  set,  the  driver  must  support  a  few  additional 
functions. 

The  next  two  fields  contain  the  offset  address  of  the  strategy  routine  and  interrupt 
routine.  The  last  field  contains  the  name  of  the  device  driver  if  it  is  a  character 
device  driver.  If  the  name  is  less  than  eight  characters  in  length,  blank  spaces 
(ASCII  code  32)  pad  the  remaining  characters.  If  it  is  a  block  device  driver,  the  first 
byte  of  this  field  contains  the  number  of  logical  devices  supported  by  the  driver. 
The  remaining  seven  bytes  of  this  field  remain  unused  and  contain  the  value  0. 

Strategy  routine 

DOS  calls  the  strategy  routine  first  to  initialize  the  driver,  then  repeatedly  before 
each  subsequent  I/O  request  fi-om  the  driver's  interrupt  routine.  The  address  of  a  data 
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Structure  which  contains  information  about  the  operation  to  be  performed  (the 
request  header)  is  passed  by  DOS  to  the  strategy  routine  in  register  pair  ES:BX. 
The  double  word  pointer  to  the  data  block  is  stored,  and  control  immediately 
returns  to  DOS.  DOS  then  calls  the  interrupt  routine  of  the  driver  to  perform  the 
actual  operation. 

The  request  header,  whose  address  is  passed  to  the  strategy  routine,  always  contains 
at  least  13  bytes  and  contains  information  which  tells  the  driver  how  to  perform 
the  upcoming  operation.  Depending  on  the  operations  performed,  further 
information  can  be  added  to  the  end  of  the  request  header  which  differs  depending  on 
the  operation. 


+ 

OOH 

Data  block  length  in  bytes 

(1 

word) 

+ 

OlH 

Device  number  in  communication 

(1 

word) 

+ 

02H 

Command  code 

(1 

word) 

+ 

OSH 

Reserved 

(8 

bytes) 

+ 

ODH 

Media  descriptor 

(1 

byte) 

T" 

OEH 

Buffer  offset  address 

(1 

word) 

+ 

lOH 

Buffer  segment  address 

(1 

word) 

T" 

12H 

Number 

(1 

word) 

+ 

14H 

Starting  sector 

(8 

bytes) 

RAM 


0000 

•0000 

1 

r 

Structure  of  the  request  header 

DOS  calls  the  interrupt  routine  immediately  after  calling  the  strategy  routine.  Its 
first  task  is  to  save  the  processor  registers  that  will  have  their  contents  changed  by 
the  various  functions  of  the  driver  to  the  stack.  Then  it  obtains  the  command  code 
from  field  3  of  the  request  header  and  calls  the  appropriate  command  code  routine. 
After  executing  the  routine,  it  fills  in  the  status  field  of  the  request  header  and 
restores  the  processor  registers  from  the  stack.  As  a  last  step  it  returns  control  to 
the  calling  DOS  function. 

Status  field 

The  value  of  the  status  field  specifies  whether  the  function  executed  without  error, 
or  if  an  error  occurred  during  execution.  For  this  reason,  every  driver  function  must 
set  the  DONE  bit  (bit  8)  in  the  status  field.  This  DONE  bit  must  be  set  even  if  the 
function  is  a  dummy  (non-performing)  function. 
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OsOK 

Iserror 


Isready 


Isbusy 


Error  coda  when  bit  15s1: 


Osmedium  write  protected 
Isunknown  device 
2sdrive  not  ready 
Ssunknown  command 
4sread  (CRC-)  error 
Ssparameter  data  biock 
has  a  faise  iength 
6ssearch  error 
7sunknown  medium 
Sssector  not  found 
9=printer  out  of  paper 
lOswrite  error 
llsread  error 
12=common  error 
13=illegal  medium  change 


Status  field  error  codes 


6.12.4  Device  Driver  Functions 

Under  DOS  Version  2,  any  installable  device  driver  must  support  13  functions, 
numbered  from  0  to  12,  even  if  their  only  action  consists  of  setting  the  DONE 
flag  in  the  status  word.  DOS  Versions  3  and  4  include  four  additional  functions 
which  can  be  supported,  but  are  not  required.  Some  of  these  functions  concern  one 
of  the  two  driver  types,  while  others  apply  to  both  driver  types  (e.g., 
initialization).  Unused  functions  must  at  least  set  the  DONE  flag  of  the  status 
word.  Let’s  look  at  the  various  functions  in  detail  according  to  their  function 
numbers. 

Request  header 

Every  function  described  here  receives  its  arguments  from  the  request  header  (whose 
address  is  passed  by  DOS  to  the  strategy  routine)  and  stores  its  "results"  in  the 
request  header.  For  this  reason,  the  offset  address  to  the  arguments,  relative  to  the 
beginning  of  the  request  header,  is  passed  to  the  specified  function.  These 
arguments  are  later  transferred  to  variables.  Besides  this  offset  address,  a  flag 
indicates  whether  this  information  consists  of  a  byte,  word  or  PTR.  The  PTR  data 
type  represents  a  pointer  to  a  buffer  and  consists  of  two  adjacent  words.  The  first 
word  is  the  offset  address  of  the  buffer.  The  second  word  is  the  segment  address  of 
the  buffer. 
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Function  0:  Driver  Initialization 

DOS  calls  this  function  during  the  system  boot  procedure  to  initialize  the  device 
driver.  This  function  can  involve  hardware  initialization,  setting  various  internal 
variables  to  their  default  values,  or  the  redirection  of  interrupts.  Since  the  entire 
operating  system  has  not  been  completely  initialized  at  this  point,  the 
initialization  routine  can  only  call  functions  1  through  OCH  and  30H  of  DOS 
interrupt  21H.  These  functions  can  be  used  to  detOTnine  the  DOS  version  number 
and  to  display  a  driver  identification  message  on  the  screen.  Even  if  the  newly 
linked  driver  is  a  CON  driver,  the  output  to  the  display  occurs  through  the  old 
CON  driver,  because  there  are  no  new  drivers  link^  into  the  system  after 
completion  of  the  initialization  routine. 

Initialization  and  the  request  header 

The  initialization  routine  can  obtain  two  pieces  of  information  from  the  request 
header.  The  first  item  is  the  memory  address  containing  the  text  following  the 
equal  sign  on  the  line  in  the  CONFIG.SYS  file  that  loaded  the  driver  into  the 
system. 

A  typical  line  in  a  CONFIG.SYS  file  can  look  like  this: 

DEVICE=ANSI.SYS 

In  this  case,  the  device  name  is  ANSI.SYS,  which  assigns  the  standard  ANSI 
esc^  sequences  for  screen  control  to  the  PC.  The  memory  address  passed  to  the 
initialization  routine  points  to  the  character  following  the  equal  sign  (in  this  case, 
the  A  of  ANSI.SYS).  This  makes  it  possible  to  store  additional  information 
following  the  name  of  the  device  driver.  This  information  is  ignored  by  DOS,  but 
can  be  read  by  other  routines. 

Logical  device  designation 

The  second  item  is  only  available  under  DOS  Version  3.0  and  higher,  and  only  if 
the  driver  is  a  block  device  driver.  This  is  the  letter  designation  of  the  first  logical 
device  of  the  driver.  The  value  0  stands  for  A,  1  for  B,  2  for  C,  and  so  on. 

The  initialization  routine  must  return  four  parameters  to  the  calling  DOS  function. 
The  first  parameter  is  the  status  of  the  function,  i.e.,  the  indication  of  whether  the 
function  has  executed  correctly.  For  a  block  device  driver,  the  number  of  logical 
devices  supported  must  also  be  passed.  This  information  could  also  be  obtained 
from  the  device  driver's  header,  but  is  igncmi  by  DOS. 
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The  next  parameter  that  the  device  driver  must  pass  to  DOS  is  the  highest  memory 
address  which  it  occupies  or  uses.  This  lets  DOS  know  where  the  next  device 
driver  can  be  installed. 


BPB 


If  the  driver  is  a  block  device  driver,  the  last  argument  passed  must  be  the  address 
of  an  array  which  contains  an  entry  f(x  every  logical  device.  This  array  contains  the 
addresses  of  BIOS  parameter  blocks  (BPBs).  The  address  is  passed  as  two  words, 
the  first  word  contains  the  offset,  and  the  second  word  ctmtains  the  segment  address 
of  the  array.  The  first  two  words  within  this  table  are  the  address  for  the  first 
logical  device  supported.  The  next  two  words  indicate  the  address  for  the  second 
logical  device,  etc.  The  BPB,  described  in  detail  in  Section  6.12,  is  a  data  block 
containing  information  which  describes  a  logical  device.  If  all  or  some  of  the 
logical  devices  have  the  same  format,  all  entries  in  the  BPB  address  table  can  point 
to  a  single  BPB. 


+  OOH 

Bytes  per  sector  (1  word) 

+  02H 

Sectors  per  cluster  (1  byte) 

+  03H 

Reserved  sectors  (including  boot  sectors)  (1  word) 

+  OSH 

Number  of  FATs  (1  byte) 

+  06H 

Maximum  number  of  entries  in  root  directory  (1  word) 

+  OSH 

Total  number  of  sectors  (1  word) 

+  OAH 

Media  descriptor  (1  byte) 

+  OBH 

Number  of  sectors  per  FAT  (1  word) 

BIOS  Parameter  Block  design 


F8H 

=  hard 

disk 

F9H 

=  5.25" 

diskette. 

double-sided. 

15 

sectors  per  track 

FCH 

=  5.25" 

diskette. 

single-sided. 

9 

sectors 

per 

track 

FDH 

=  5.25" 

diskette. 

double-sided. 

9 

sectors 

per 

track 

FEH 

=  5.25" 

diskette. 

single-sided. 

8 

sectors 

per 

track 

FFH 

=  5.25" 

diskette. 

double-sided. 

8 

sectors 

per 

track 

Media  descriptor  byte 
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1  Calling  parameters  of  function  0:  I 

Function  number  (0) 

Offset  18  (ptr) 

Address  of  character  that  follows  the  equal  sign  aft^  the 
DEVICE  command  in  the  CONFIG.SYS  file 

Offset  22  G>yte) 

Device  number  of  the  first  device  supported  by  the  driver 
(0=A,  1=B...)  (applies  to  block  device  drivers  from  DOS 
Version  3.0  up  onlv) 

1  Returned  narameta^  of  function  0:  1 

1  Offset  3  (word) 

Status  word 

Number  of  devices  supported  (block  devices  only) 

Offset  14  (ptr) 

Address  of  first  available  memory  location  following  the 
driver 

Offset  18  (ptr) 

Address  of  array  containing  the  addresses  of  BPB  (block 
devices  only) 

Function  1:  Media  Check 

This  function  is  used  only  with  a  block  device  driver.  A  character  device  driver 
should  merely  set  the  DONE  flag  of  the  status  word  and  exit.  This  function  is  used 
by  DOS  to  determine  whether  the  media  (diskette)  has  changed.  It  is  often  used 
when  examining  a  disk  directory.  If  the  disk  medium  was  not  changed  since  the 
last  access,  DOS  still  has  this  information  in  memory,  otherwise  DOS  must  reread 
the  information  from  the  media  which  delays  the  execution  of  the  current  task. 

In  some  cases,  as  with  floppy  disks,  the  answer  to  the  question  is  fairly 
complicated.  For  this  reason  DOS  permits  function  1  to  answer  not  only  with 
"yes"  and  "no",  but  also  with  "don't  know."  In  any  case,  the  answer  affects  further 
DOS  activity. 

If  the  media  is  unchanged,  access  to  the  media  can  take  place  immediately.  If  the 
media  was  changed,  however,  DOS  closes  all  internal  buffers  related  to  the  current 
logical  device.  This  causes  the  loss  of  all  data  which  should  have  been  transmitted 
to  the  media.  Then  it  calls  function  2  of  the  current  device  driver,  loads  the  FAT 
and  the  root  directory.  If  the  media  check  function  answers  with  "don't  know,"  the 
additional  steps  taken  by  DOS  depend  on  the  status  of  the  internal  buffers  related  to 
the  current  logical  device.  If  these  internal  buffers  are  empty,  DOS  assumes  that 
the  media  was  changed  and  acts  as  if  function  1  answered  "yes."  If  the  buffers 
contain  data  which  should  have  been  transmitted  to  the  media,  DOS  assumes  that 
the  media  is  intact  and  writes  the  data.  If  the  media  was  indeed  changed,  the  data 
written  to  a  changed  media  may  damage  the  new  diskette's  file  structure. 

Since  subsequent  processing  depends  on  the  response  from  the  media  check 
function,  the  driver  should  handle  the  response  carefully.  Before  enabling  the 
mechanism  used  by  the  function  to  respond,  the  function  examines  the  parameters 
passed  to  it.  If  the  driver  supports  several  logical  devices,  the  first  parameter  is  the 
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number  of  devices.  Next  is  a  media  descriptor  code.  This  code  contains  information 
about  the  type  of  media  last  used  in  the  current  logical  device.  Only  devices  which 
can  handle  several  different  formats  can  use  this  ta^.  For  example,  AT  disk  drives 
which  can  use  both  360K  and  1.2  megabyte  diskette  formats. 

If  the  media  check  function  determines  that  the  medium  in  a  device  is  non¬ 
removable  (e.g.,  a  fixed  disk),  it  can  always  respond  ”not  changed”.  If,  on  the  other 
hand  the  device  media  can  be  changed  (e.g.,  a  disk),  the  correct  response  can  only 
be  determined  by  fairly  complex  procedures.  If  these  procedures  are  not  used,  the 
response  should  be  ”don*t  know". 

For  the  sake  of  completeness,  here  are  the  three  procedures  which  provide  fairly 
accurate  results. 

Since  a  device  with  changeable  media  has  an  opening  and  closing  mechanism,  the 
function  should  check  to  determine  whether  the  media  was  removed.  However,  it 
cannot  determine  if  the  removed  media  is  identical  to  the  newly  inserted  medium. 

If  the  media  has  a  name,  the  function  should  read  this  name  to  determine  whether 
the  media  was  changed.  This  procedure  only  makes  sense  if  every  media  has  a 
unique  name. 

The  disk  drive  procedure  used  by  DOS  hinges  on  the  fact  that  changing  medium 
takes  some  time.  DOS  assumes  that  even  a  user  that  can  move  fast  needs  about 
two  seconds  to  remove  a  diskette  from  a  drive  and  insert  a  new  diskette  in  the  same 
drive.  If  two  consecutive  diskette  accesses  occur  less  than  two  seconds  £q)art,  DOS 
assumes  that  no  diskette  change  occurred. 

A  byte  in  the  data  block  is  used  to  indicate  changes.  The  value  -1  (FFH)  means 
"changed",  0  means  "don’t  know"  and  1  means  "not  changed". 

If  the  media  was  changed,  the  device  driver  signals  a  media  change  (bit  1 1  in  the 
device  attribute  =  1),  the  address  of  a  buffer  must  be  passed  to  DOS  Version  3  and 
newer,  which  contains  the  volume  name  of  the  previous  media.  This  name  must 
be  stored  there  as  an  ASCII  string  and  terminated  with  an  end  character  (ASCII 
codeO). 


1  Calling  parameters  of  function  1:  I 

Device  number  I 

Media  descriptor  byte  1 
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1  Returned  paramet^s  of  function  1:  I 

CMfset  3  (wotcD 

Status  word 

Offset  14  (byte) 

Was  media  changed  ? 

FFH  =  ves,  OOH  =  don't  know,  OlH  =  no 

Offset  15  (pit) 

Address  of  buffer  containing  the  previous  volume  name 
(only  if  device  indicates  a  media  change) 

Function  2:  Build  BIOS  Parameter  Block  (BPB) 

This  function  is  used  only  by  block  device  drivers.  A  character  device  driver  should 
just  set  the  DONE  flag  of  the  status  word  and  exit.  DOS  calls  this  function  when 
the  media  check  function  determines  that  the  media  was  changed.  This  function 
returns  a  pointer  to  a  new  BPB  for  the  media. 

As  you  can  see  by  the  layout  of  the  calling  parameters,  the  device  number  media 
descriptor  and  a  pointer  to  a  buffer  are  passed  to  this  function  by  DOS.  If  the 
device  is  a  stand^d  format  (bit  13  of  the  device  attribute  =0),  then  the  buffer 
contains  the  first  sector  of  the  FAT. 


1  Calling  parameters  of  function  2:  1 

Device  number  1 

Media  descriptor  byte 

1  Offset  14  (ptr) 

Address  of  a  buffer  containing  the  FAT  (see  above) 

1  Returned  parameters  of  function  2:  1 

Offset  3  (wOTd) 

Status  word 

Offset  18  (ntr) 

Address  of  the  BPB  of  addressed  device 

Function  3:  I/O  Control  Read 

This  function  passes  control  information  from  the  character  or  block  device  driver 
to  the  application  program.  It  can  only  be  called  through  function  44H  of  interrupt 
21H  if  the  lOCTL  bit  in  the  device  attribute  word  in  the  device  driver  header  is  set 
Different  parameters  are  passed  to  the  function,  depending  on  whether  the  driver  is 
a  Ciiaracter  ot  a  block  device  driver. 

A  character  device  driver  is  passed  the  number  of  characters  to  be  transferred  and  the 
address  of  a  buffer  foe  the  transfer  of  the  data. 

A  block  device  driver  is  passed  the  device  number,  the  media  descriptor  byte,  the 
address  of  the  buffer  to  be  used  for  the  data  transfer,  the  pointer  to  the  first  sector  to 
be  read  and  the  number  of  sectors  to  be  read. 
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1  Calling  parameters  of  function  3:  1 

Device  number  (block  devices  only)  I 

isBma 

LtJiRaBKlIiErSl 

Media  descriptor  byte  (block  devices  only) 

Offset  14  (ptr) 

Address  of  buffer  into  which  data  should  be  transmitted 

Offset  18  (word) 

Number  of  secttM^  to  be  read  (block  device)  ot 

Number  of  charactes  to  be  re^  (character  device) 

Uj  I  iSHtTiWBffH 

First  sector  to  be  read  (block  devices  only) 

1  Returned  parameters  of  function  3:  1 

Offset  3  (word) 

Status  word 

Offset  18  (wOTd) 

Number  of  sectors  read  (block  device) 

Number  of  characters  read  (character  ^vice) 

Function  4:  Read 

This  function  reads  data  from  the  device  to  a  buffer  specified  in  the  calling 
parameter.  Should  an  error  occur  reading  the  data,  the  error  status  must  be  set. 
Additionally  the  function  must  report  the  number  of  sectors  or  bytes  read 
successfully.  Simply  reporting  an  error  is  not  good  enough. 


1  Calling  parameters  of  function  4:  I 

Device  number  (block  device  only)  I 

Media  descriptor  byte  (block  device  only) 

Address  of  buffer  to  which  data  should  be  read 

Offset  18  (word) 

Number  of  sectOTS  to  be  read  (block  device)  or 

Number  of  charactCTS  to  be  read  (character  device) 

First  sector  to  be  read  (block  device  only) 

1  Returned  parameters  of  function  4:  I 

Status  word 

Offset  18  (word) 

Number  of  sectors  read  (block  device)  or 

Number  of  charactCTS  read  (characta*  device) 

Offset  22  (ptr) 

Pointer  to  volume  ID  on  return  of  error  OFH  (Version  3.0 
and  higher) 

Function  5:  Non-destructive  Read 

This  function  is  used  by  a  character  device  driver  to  test  for  unread  characters  in  the 
input  buffer.  A  block  device  should  set  the  DONE  flag  of  the  status  word  and  exit. 

DOS  tests  for  additional  characters  using  this  function.  If  more  characters  exist,  the 
busy  bit  must  be  cleared  (set  to  0)  and  the  next  character  passed  to  DOS.  The 
character  that  is  passed  remains  in  the  buffer  so  that  a  subsequent  call  to  a  read 
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function  will  return  this  same  character.  If  no  additional  characters  exist,  the  busy 
bit  must  be  set  (set  to  1). 


Calling  parameter  of  function  5: _ 

Offset  2  (byte)  I  Function  number  (5) 


1  Returned  parameters  of  function  5:  1 

1  Offset  3  (word)  1 

Status  word 

The  character  read 

Function  6:  Input  Status 

This  function  is  used  to  determine  if  a  character  is  waiting  to  be  read  from  the 
input  buffer  of  a  character  device.  A  block  device  driver  should  set  the  DONE  flag 
of  the  status  word  and  exit. 

If  a  character  is  waiting  to  be  read  from  the  input  buffer,  the  busy  bit  is  cleared  (set 
to  0).  If  a  character  is  not  in  the  input  buffer,  the  busy  bit  is  set  (set  to  1). 

When  a  character  is  waiting  to  be  read,  the  Input  Status  function  (06H)  resets  the 
status  word  busy  bit  to  0  and  returns  the  character  to  DOS.  The  character  is  not 
removed  from  the  buffer  and  is  therefore  non-destructive.  This  function  is 
equivalent  to  a  one-character  look  ahead. 


Calling  parameter  of  function  6: 

Offset  2  (byte)  |  Function  number  (6) 


Returned  parameters  of  function  6:  I 

Offset  3  (word) 

Status  word:  Characters  already  in  buffer  =  0;  Read  request  to 
physical  device  =  1 

Function  7:  Flush  Input  Buffers 

This  function  clears  the  internal  input  buffers  of  a  character  device  driver.  Any 
characters  read  but  not  yet  passed  to  DOS  are  lost  when  this  function  is  used.  A 
block  device  driver  should  set  the  DONE  flag  of  the  status  word  and  exit 


Calling  parameter  of  function  7: 

Offset  2  (byte)  I  Function  number  (7) 


Returned  parameter  of  function  7: 
Offset  3  (word)  I  Status  word 
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Function  8:  Write 

This  function  transfers  characters  from  a  buffer  to  the  current  device.  If  an  error 
occurs  during  transmission,  the  status  word  is  used  to  indicate  this  error.  Both 
block  and  character  devices  use  this  function. 

The  parameters  used  for  this  function  depend  on  whether  the  driver  is  for  a  character 
or  block  device.  Both  pass  a  buffer  address  from  which  a  certain  number  of 
characters  should  be  transferred.  A  character  device  driver  is  passed  the  number  of 
bytes  to  be  transferred  in  addition  to  this  information. 

A  block  driver  is  passed  the  number  of  sectors  to  transfer  (not  the  number  of 
characters),  the  number  of  the  device  to  be  addressed,  its  media  descriptor  and  the 
address  of  the  first  sector  on  the  medium. 

Should  an  error  occur  writing  the  data,  the  error  status  must  be  set.  Additionally 
the  function  must  report  the  number  of  sectors  or  bytes  written  successfully. 
Simply  reporting  an  error  is  not  good  enough. 


1  Calling  parameters  of  function  8:  1 

Device  number  (block  drivers  only)  I 

1 

I 

KsiiMiam 

Media  descriptor  of  device  addressed  (block  device  only) 

Address  of  the  buffer  containing  data 

Offset  18  (word) 

Number  of  sectors  to  be  written  (block  device) 

Number  of  characters  to  be  written  (character  device) 

first  sector  to  be  written  (block  device  only) 

Returned  parameters  of  function  8:  1 

status  word 

Offset  18  (word) 

Number  of  sectors  written  (block  device) 

Number  of  characters  written  (character  device) 

Offset  22  (ptr) 

Pointer  to  volume  ID  on  return  of  error  OFH  (Version  3.0 
JiEi _ 

Function  9:  Write  with  Verify 

This  function  is  similar  to  function  8,  but  with  the  difference  that  the  characters 
written  are  reread  and  verified. 

Some  devices,  especially  character  devices  such  as  a  monitor  or  a  printer,  do  not 
require  verification  since  either  no  errors  occur  during  transmission  (monitor)  or 
the  data  cannot  be  verified  (printer). 
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1  Calling  parameters  of  function  9:  I 

Device  number  (block  drivers  only)  I 

Media  descriptor  of  device  addressed  (block  device  only) 

Offset  14  (ptr) 

Address  of  the  buffer  containing  data 

Offset  18  (word) 

NumbCT  of  sectors  to  be  written  (block  device) 

Number  of  characters  to  be  written  (character  device) 

Offset  20  (word) 

First  sector  to  be  written  (block  device  only) 

1  Returned  parameters  of  function  9:  I 

Offset  3  (word) 

Status  word 

Offset  18  (word) 

Number  of  sectors  written  (block  device) 

Number  of  characto's  written  (character  device) 

Offset  22  (ptr) 

Pointer  to  volume  ID  on  return  of  error  OFH  (Version  3.0 
up) 

Function  10:  Output  Status 

This  function  indicates  whether  the  last  write  operation  to  a  character  device  is 
completed  or  not.  A  block  device  should  set  the  DONE  flag  in  the  status  word  and 
exit. 

If  the  last  write  operation  is  complete  then  the  busy  bit  of  the  status  word  is 
cleared;  otherwise  the  busy  bit  is  set  to  1. 


Calling  parameter  of  function  10: 

Offset  2  (byte)  I  Function  number  (10) 


1  Returned  parameter  of  function  10:  I 

Offset  3  (word) 

Status  word:  The  busy  bit  is  1  if  the  last  character  output 
has  not  been  complete 

Function  11:  Flush  Output  Buffers 

This  function  completely  clears  the  output  buffer  even  if  it  contains  characters 
waiting  for  output.  A  block  device  should  set  the  DONE  flag  on  the  status  word 
and  exit. 


Calling  parameter  of  function  11: _ 

Offset  2  (byte)  I  Function  number  (11) 


Returned  parameter  of  function  1 1: 
Offset  3  (word)  |  Status  word 
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Function  12:  I/O  Control  Write 

This  function  passes  control  information  from  the  application  program  to  the 
character  or  block  device  driver.  It  can  only  be  called  through  function  44H  of 
interrupt  21H  provided  the  lOCTL  bit  in  the  device  attribute  word  in  the  device 
driver  header  is  set.  Different  parameters  are  passed  to  the  function,  depending  on 
whether  the  driver  is  a  character  or  a  block  device  drivCT. 

A  character  device  driver  is  passed  the  numb^  of  characters  to  be  written  and  the 
address  of  the  buffer  from  which  these  characters  are  transferred. 

A  block  device  driver  is  passed  the  device  number  (in  case  the  driver  services 
logical  devices),  the  media  descriptOT  byte,  the  address  of  the  buffer  from  which  the 
data  is  to  be  written,  the  number  of  the  first  sector  to  be  written  and  the  number  of 
sectors  to  be  written. 

A  character  device  driver  returns  the  number  of  bytes  written.  A  block  device  driver 
returns  the  number  of  sectors  written. 


1  Calling  parameters  of  function  12:  1 

Device  number  (block  device  only)  I 

Mgs&onsa 

Media  descriptor  of  addressed  device  (block  device  only) 

bjnsafainitiM 

Address  of  buffer  from  which  data  should  be  read 

Offset  18  (word) 

Number  of  sectors  to  be  written  (block  device) 

Number  of  characters  to  be  written  (character  device) 

Offset  20  (word) 

First  sector  to  be  written  (block  device  only) 

1  Returned  parameters  of  function  12:  I 

Offset  3  (word) 

Status  word 

Offset  18  (word) 

Number  of  sectOTS  written  (block  device) 

Number  of  chaiactCTS  written  (character  device) 

The  following  four  functions  are  supported  by  DOS  version  3.0  and  higher. 

Function  13:  Open 

This  function  can  be  used  only  if  the  OCR  (Open/Close/RM)  bit  in  the  device 
attribute  word  in  the  device  driver  header  is  set  Its  task  differs,  depending  whether 
it  is  a  character  or  block  driver. 

A  block  driver  uses  this  function  every  time  a  file  is  opened.  This  function 
determines  how  many  open  files  exist  on  this  device.  Use  this  command  carefully, 
since  programs  which  access  FCB  function  calls  tend  not  to  close  open  files.  This 
problem  can  be  avoided  by  assuming  during  every  media  change  that  no  files 
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remain  open.  For  devices  with  non-changeable  media  (e.g.,  a  hard  disk)  even  this 
procedure  may  not  help. 

Within  a  character  driver,  this  function  can  send  an  initialization  string  to  the 
device  before  transmitting  the  data.  This  is  an  advantage  when  used  for 
communication  with  the  printer.  The  initialization  siring  should  not  be  included  in 
the  driver,  but  can  be  called,  for  example,  with  the  lOCTL  function  of  interrupt 
21H,  which  calls  function  12  of  a  driver  to  transmit  it  from  an  application 
program  to  the  driver.  The  function  can  also  be  useful  because  it  can  prevent  two 
processes  (in  a  network  or  in  multiprocessing)  from  both  accessing  the  same 
device. 

For  the  devices  CON,  PRN  and  AUX,  this  function  is  not  called  since  they  are 
always  open. 


1  Calling  parameters  of  function  13:  1 

Device  number  (block  device  only)  I 

Returned  parameter  of  function  13: 
Offset  3  (word)  I  Status  word 


Function  14:  Device  Close 

This  function  is  the  opposite  of  function  13.  This  function  can  only  be  addressed  if 
the  OCR  bit  in  the  device  attribute  word  of  the  device  driver  header  is  set  Its  task 
differs,  depending  whether  it  is  a  character  or  block  driver. 

A  block  driver  calls  it  after  closing  a  file.  This  can  be  used  to  decrement  a  count  of 
open  files.  Once  all  files  on  a  device  are  closed  the  driver  should  flush  the  buffers 
on  removable  media  devices,  because  it  is  likely  that  the  user  is  about  to  remove 
the  media. 

A  character  driver  can  use  this  function  to  send  some  closing  control  information 
to  a  device  after  completing  output.  For  a  printer  this  could  be  a  formfeed.  As  in 
function  13,  the  string  could  be  transmitted  from  an  supplication  program  using  the 
lOCTL  function. 


1  Calling  parameters  of  function  14:  I 

Offset  1  (byte) 

Device  number  (block  device  only) 

Offset  2  (byte) 

Function  number  (14) 

Returned  parameter  of  function  14: 
Offset  3  (word)  I  Status  word 
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Function  15:  Removable  Media 

This  function  indicates  if  the  media  in  a  block  device  can  be  changed  or  not.  This 
function  is  used  only  if  the  OCR  bit  in  the  device  attribute  word  of  the  device 
driver  is  set.  A  character  device  driver  should  set  the  DONE  flag  in  the  status  word 
and  exit 

If  the  media  can  be  removed,  the  busy  bit  is  cleared;  otherwise  it  is  set  to  1. 


1  Calling  parameters  of  function  15:  1 

Device  number  (block  device  only) 

Function  number  (15) 

1  Returned  parameter  of  function  15:  1 

Offset  3  (word) 

Status  word:  If  the  media  can  be  removed,  the  busy  bit  must 
contain  the  value  0 

Function  16:  Output  until  Busy 

This  function  transfers  data  from  a  buffer  to  an  output  device  until  the  device  is 
busy  (i.e.,  can  no  longer  accept  more  characters).  As  this  function  is  supported  by 
character  devices,  a  block  device  driver  should  set  the  DONE  flag  on  the  status 
wOTd  and  exit 

This  function  works  particularly  well  with  print  spoolers,  through  which  files  can 
be  sent  to  a  printer  as  a  background  activity  while  a  program  executes  in  the 
foreground.  It  is  possible  that  not  all  of  the  characters  in  the  transfe*  request  will 
be  sent  to  a  device  during  this  function  call.  This  is  usually  not  an  error,  it  could 
be  the  result  of  the  device  becoming  busy.  The  function  is  passed  the  number  of 
characters  to  be  transmitted  as  well  as  the  buffer  address.  If  the  output  device 
indicates  during  transmission  that  it  can  no  longer  accept  additional  characters,  it 
indicates  the  number  of  characters  successfully  transferred  and  returns  control  to  the 
device  driver. 


1  Calling  parameters  of  function  16:  1 

Offset  14  (otr) 

Address  of  buffer  from  which  data  should  be  read 

Offset  18  (word) 

Number  of  characters  to  be  read 
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1  Returned  parameters  of  function  16:  1 

Offset  3  (word) 

Status  word 

Offset  18  (word) 

Number  of  charact^  written 

6.12.5  Clock  Driver 

The  clock  driver  is  a  character  device  driver  whose  only  function  is  to  pass  the  date 
and  time  from  DOS  to  an  application.  The  clock  driver  can  also  have  a  different 
name,  since  DOS  identifies  it  by  the  fact  that  bit  2  in  the  device  attribute  word  of 
the  device  driver  header  is  set  to  1,  instead  of  by  name.  Bit  15  must  also  be  set 
since  the  clock  driver  is  a  character  device  driver.  Functions  2AH  to  2DH  of  DOS 
interrupt  21H  read  the  date  and  time  and  call  the  driver.  A  clock  driver  must 
support  only  functions  4,  8  and  0  (initialization).  During  the  call  of  function  4 
(reading),  the  date  and  time  pass  from  the  driver  to  DOS.  DOS  can  set  a  new  date 
and  time  with  function  8.  Both  functions  have  the  time  and  date  passed  in  a  buffer 
of  6  bytes  in  length. 


+  OOH 

Number  of  days  since  Jan. 1^1980  (1  word) 

+  02H 

Minutes  (1  byte) 

+  03H 

Hour  (1  byte) 

+  04H 

Hundredths  of  seconds  (1  byte) 

+  OSH 

Seconds  (1  byte) 

RAM 


i 

■ 

Passing  date  and  time  to  a  clock  driver 

The  date  format  is  unusual.  Instead  of  passing  the  month,  day  and  year  separately, 
DOS  passes  the  number  of  days  elapsed  since  January  1, 1980  as  a  16-bit  number. 
A  fairly  complex  formula  converts  this  number  into  normal  date  format,  taking 
leap  years  into  account.  The  clock  driver  normally  uses  function  0  and  1  of  the 
BIOS  interrupt  1  AH  to  read  and  set  the  time. 

Clocks  on  AT  models 

AT  and  AT-compatible  computers  have  a  battery  powered  realtime  clock. 
Functions  0  and  1  of  interrupt  1  AH  use  a  software  controlled  time  counter  and  not 
the  battery  powered  realtime  clock.  When  the  computer  is  rebooted,  the  date  and 
time  previously  set  with  driver  function  8  is  cleared.  You  can  use  the  clock  driver 
to  access  the  realtime  clock  using  functions  2  and  5  of  interrupt  lAH  instead  of 
function  0  and  1. 
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6.12.6  Device  Driver  Cails  from  DOS 

Now  that  you  have  some  familiarity  with  the  functions  of  the  different  device 
drivers,  you  can  look  toward  developing  your  own  personal  device  driver.  Here  are 
the  steps  which  take  place  before  and  after  calling  a  device  driver  function. 

A  chain  of  events  begins  when  a  DOS  function  which  handles  input  and  output  is 
called  using  interrupt  21H.  Calling  one  of  these  functions  can  in  turn  call  a  series 
of  other  functions  and  corresponding  read  and  write  operations. 


Open 


One  example  of  this  is  when  the  Open  function  3DH  is  called  to  open  a  file  in  a 
subdirectory.  First  of  all,  before  it  can  be  opened,  DOS  must  find  the  file.  This 
may  require  the  searching  of  a  set  of  directories  instead  of  just  reading  in  the  FAT. 
During  each  access  of  interrupt  21H,  DOS  determines  which  of  the  available  device 
drivers  should  be  used  to  read  or  write  characters.  When  this  happens,  DOS  sets 
aside  an  area  in  memory  to  store  the  information  required  by  the  device  driver. 

For  files,  DOS  must  convert  the  number  of  records  to  be  processed  into  logical 
sector  numbers.  DOS  then  calls  the  strategy  routine  of  the  device  driver,  to  which 
it  passes  the  address  of  the  newly  created  data  block  (request  header).  Then  the 
interrupt  routine  of  the  driver  is  called,  which  stores  all  registers.  It  isolates  the 
function  code  of  the  requested  function  from  the  data  block  and  starts  to  process  the 
function. 

If  the  addressed  driver  is  a  character  device  driver,  the  function  only  has  to  send  the 
characters  to  the  hardware  or  request  the  characters  to  be  read. 

Block  devices 

For  a  block  device  (e.g.,  a  mass  storage  device  such  as  a  floppy  or  hard  disk)  the 
logical  sector  number  must  be  converted  into  a  physical  address  before  a  read  or 
write  access.  The  logical  sector  number  is  broken  down  into  a  head,  track  and 
physical  sector  number. 

After  the  read  or  write  operation  ends,  the  driver  function  must  place  a  result  code 
in  the  status  field  of  the  request  header  to  be  returned  to  the  calling  DOS  function. 
Next  the  contents  of  all  registers  are  restored  and  control  is  returned  to  the  calling 
DOS  function,  which,  depending  on  the  result  of  the  driver  function,  sets  or  resets 
the  carry  flag  and  places  any  error  code  into  the  AX  register.  The  interrupt  function 
then  returns  control  to  the  routine  which  called  interrupt  21H. 
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6.12.7  Direct  Device  Driver  Access:  lOCTL 

Here  we  discuss  lOCTL  in  detail,  since  it  offers  an  alternate  method  of 
communicating  with  the  device  driver.  You  can  only  use  these  functions  if  the 
lOCTL  bit  of  the  device  attribute  is  set 

The  lOCTL  function  itself  is  one  of  many  functions  addressable  from  DOS 
interrupt  21H.  Its  function  number  is  44H.  Three  groups  of  sub-functions  are 
accessible: 

•  Device  configuration 

•  Data  transmission 

•  Driver  status 

The  number  of  the  desired  sub-function  is  passed  to  the  lOCTL  function  in  the  AL 
register.  After  the  function  call,  the  carry  flag  indicates  whether  the  function 
executed  correctly.  A  set  carry  flag  indicates  the  occurrence  of  an  error  and  the  error 
code  can  be  found  in  the  AX  register. 

Character  device  driver  status 

The  number  of  the  desired  sub-function  is  passed  to  the  lOCTL  function  in  the  AL 
register.  After  the  function  call,  the  carry  flag  indicates  whether  the  function 
executed  correctly.  A  set  carry  flag  indicates  the  occurrence  of  an  error  and  the  error 
code  can  be  found  in  the  AX  register. 

Sub-functions  6  and  7  can  determine  the  status  of  a  character  device  driver.  Sub¬ 
function  6  can  determine  if  the  device  is  able  to  receive  data.  Sub-function  7  can 
determine  if  the  device  can  send  data.  The  handle  of  this  device  is  passed  in  the  BX 
register. 

If  the  device  is  ready,  both  functions  6  and  7  return  the  value  FFH  in  the  AL 
register. 

Sub-function  2  reads  control  data  from  the  character  device  driver.  The  handle  is 
passed  in  the  BX  register  and  the  number  of  bytes  to  be  read  is  passed  in  the  CX 
register.  In  addition,  the  DS:DX  register  pair  contain  the  address  of  the  buffer  into 
which  the  data  will  be  read.  If  the  carry  flag  is  clear,  then  the  function  was 
successful  and  the  AX  register  contains  the  number  of  characters  read.  If  the  carry 
flag  is  set,  then  there  was  an  error  and  the  AX  register  contains  the  error  code. 

Sub-function  3  writes  control  information  from  a  buffer  to  the  character  device 
driver.  Again,  the  handle  is  passed  in  the  BX  register,  the  number  of  bytes  to  be 
written  in  the  CX  register  and  the  address  of  the  buffer  in  the  DS:DX  register  pair. 
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The  return  codes  are  the  same  as  for  sub-function  2.  These  two  sub-functions  are 
used  to  pass  information  between  the  ^plication  program  and  the  device  driv^. 

Block  device  driver  status 

Sub-functions  4  and  5  have  the  same  task  as  sub-functions  2  and  3.  However,  they 
are  used  for  block  devices  and  not  character  devices.  Instead  of  passing  the  handle  in 
register  BX,  you  pass  the  drive  code  (0=A,  1=B,  etc.)  in  the  BL  register. 

Sub-function  0  is  used  to  get  device  information  for  a  specified  handle.  The  sub¬ 
function  number  is  passed  in  the  AL  regist^  and  the  handle  in  the  BX  register.  The 
function  returns  the  device  information  word  in  the  DX  register. 


For 

block  devices: 

bits  8-15 

— 

reserved 

bit? 

= 

0  if  a  block  device 

bit  6 

= 

0  if  file  has  been  written 

1  if  file  has  not  been  written 

bits  0-5 

= 

drive  code  (O^A,  B=l,  etc.) 

For 

character  devices: 

bit  15 

= 

reserved 

bit  14 

1  if  device  supports  lOCTL  sub-functions 
0  if  device  does  not  support  lOCTL  sub¬ 
functions 

bits  8-13 

= 

reserved 

bit? 

= 

if  a  character  device 

bit  6 

= 

0  if  end  of  file  for  input  device 

bit  5 

= 

0  if  cooked  mode 

1  if  raw  mode 

bit  4 

= 

reserved 

bits 

= 

1  if  clock  device 

bit  2 

= 

1  if  NUL  device 

bit  1 

= 

1  if  standard  output  device 

bitO 

= 

1  if  standard  input  device 

Cooked  and  raw  modes 

Sub-function  1  is  used  to  set  device  information  for  a  specified  handle.  This  sub¬ 
function  is  often  used  to  set  the  standard  input  device  from  cooked  mode  to  raw 
mode  or  back. 

Two  final  interrupts  are  sometimes  used  by  block  device  drivers.  These  two 
interrupts,  25H  and  26H  are  used  to  read  from  and  write  to  the  disk  drive.  You  can 
use  these  interrupts,  for  example,  to  process  disks  that  were  formatted  using  a 
’’foreign"  operating  system. 
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The  device  number  is  passed  in  the  AL  register,  the  number  of  sectors  to  be 
transferred  is  passed  in  the  CX  register,  the  starting  sector  number  to  be  transferred 
is  passed  in  the  DX  register  and  the  buffer  is  passed  in  the  DS:BX  register.  The 
carry  flag  is  clear  if  there  was  no  errors.  If  the  carry  flag  is  set,  then  the  error  code 
is  returned  in  the  AX  register. 


6.12.8  Tips  on  Developing  Device  Drivers 

Major  headaches  in  developing  a  device  driver  occur  because  of  problems  that  arise 
during  the  testing  phases  of  a  new  driver.  First,  a  device  driver  must  load  into  a 
memory  location  assigned  to  it  by  DOS,  at  an  address  unknown  to  the 
programmer.  Second,  a  newly  developed  CON  driver  can't  be  tested  using  the 
DEBUG  program,  since  DEBUG  uses  this  driver  for  character  input  and  output. 

We  recommend  that  after  you  write  the  actual  driver,  you  write  a  short  test 
program  that  calls  the  individual  functions  in  the  same  manner  as  DOS,  but 
without  having  the  driver  installed  as  part  of  DOS.  The  advantages  to  this  are  that 
everything  executes  under  user  control,  and  the  whole  process  can  be  corrected  with 
a  debugger.  In  any  case,  a  new  device  driver  (especially  a  block  device  driver) 
should  only  be  linked  into  the  system  after  it  has  been  tested  completely  and  has 
been  proven  to  be  error-free. 

Note:  When  working  with  a  hard  disk,  prepare  a  floppy  system  diskette 

before  test  booting  the  system  from  the  hard  disk  with  the  new  driver 
installed  for  the  first  time.  If  a  small  bug  should  exist  in  the  new 
driver,  and  the  initialization  routine  hangs  up,  the  booting  process 
will  not  end  and  DOS  will  be  out  of  control.  In  such  a  case,  the  only 
remedy  is  to  reset  the  system  and  boot  with  a  DOS  diskette  in  the 
floppy  drive.  Once  DOS  loads,  you  can  then  access  the  hard  disk  and 
remove  the  new  driver. 

6.12.9  Driver  Examples 

This  section  contains  a  sample  device  driver  for  each  of  the  three  different  types  of 
device  drivers,  to  demonstrate  the  information  you've  read  about  so  far. 

The  first  program  is  a  character  driver  which  corresponds  exactly  to  the  format  of  a 
normal  console  driver.  The  second  program  is  a  block  device  driver  which  creates  a 
160K  RAM  disk.  The  final  program  is  a  DOS  clock  driver  to  support  an  AT 
computer  realtime  clock. 


C  O  N  D  R  V 


Task  :  This  program  represents  a  normal  Console  *; 

Driver  {Keyboard  and  Display  Monitor) .  It  should  *; 
serve  as  a  framework  for  a  driver  in  the  form  of  *; 
an  ANSI. SYS  driver.  *; 
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•  ★ 

•  * 

Author 
developed  on 
last  Update 

:  MICHAEL  TISCHER 
:  8.4.87 

:  9.21.87 

* . 
t 

* . 

/ 

*  • 

it 

assembly 

:  MASM  CONDRV/ 

f 

*  . 

$ 

it 

LINK  CONDRV/ 

it  • 

r 

* 

EXE2BIN  CONDRV  CONDRV. SYS 

★  • 

9 

Call 

:  Copy  into  Root  Directory,  copy  the  conmand 

9 

it  • 

9 

* 

DEVICE-CONDRV.SYS  into  the  file  CONFIG.SYS 

it  • 

9 

* 

and  then  boot  the  System. 

■k  . 

★  ★  ★ 

****★**★★*★★*** 

*******★***★**★★*★********★**★★*★**********★★*★★* 

code 

segment 

assume  cs; 

code, ds : code , es : code, ss : code 

org  0 

/Program  has  no  PSP  therefore  start 

Constants  ===== 

/at  Offset  address  0 

cmd_fld 

equ 

2 

/Offset 

command  field  in  data  block 

status 

equ 

3 

/Offset 

status  field  in  data  block 

end_adr 

equ 

14 

/Offset 

driver  end-adr.  in  data  block 

num_db 

equ 

18 

/Offset 

number  in  data  block 

b_adr 

equ 

14 

/Offset 

buffer  address  in  data  block 

KEY_SZ 

equ 

20 

/Size  of  key  board  buffer 

num  cmd 

equ 

16 

/Subfunctions  0-16  are  supported 

; —  Header  of  Device  Driver  — 
dw  -1,-1 

dw  1010100000000011b 
dw  offset  strat 
dw  offset  intr 
db  "CONDRV  •' 


; Connect ion  to  next  driver 
; Driver  attribute 
/Pointer  to  strategy  routine 
/Pointer  to  interrupt  routine 
/new  Console  driver 


Jump  Table  for 

functions  — 

tab  dw 

offset 

init 

/Function 

0: 

dw 

offset 

dummy 

/Function 

1: 

dw 

offset 

dummy 

/Function 

2: 

dw 

offset 

no  sup 

/Function 

3: 

dw 

offset 

read 

/Function 

4: 

dw 

offset 

read  b 

/Function 

5: 

dw 

offset 

dummy 

/Function 

6: 

dw 

offset 

del__in_b 

/ Funct ion 

7: 

dw 

offset 

write 

/ Funct ion 

8: 

dw 

offset 

write 

/Function 

9: 

dw 

offset 

dummy 

/Function 

10: 

dw 

offset 

dummy 

/Function 

11; 

dw 

offset 

nosup 

/Function 

12: 

dw 

offset 

dummy 

/Function 

13: 

dw 

offset 

dummy 

/ Funct ion 

14: 

dw 

offset 

dummy 

/Function 

15: 

dw 

offset 

write 

/Function 

16: 

Initialization 
Media  Check 
Create  BPB 
I/O  control  read 
Read 

Non-dest .  Read 
Input -St at us 
Erase  Input-Buffer 
Write 

Write  &  Verify 
Output-Status 
Erase  Output-Buffer 
I/O  control  write 
Open  (starting  at  3.0) 
Close 

changeable  Medium 
Output  until  Busy 


db_ptr  dw  (?),(?) 


/Address  of  data  block  passed 


key_a  dw  0 

key_e  dw  0 

key_bu  db  KEY_SZ  dup  (?) 


/Pointer  to  next  character  in  KEY_SZ 
/Pointer  to  last  character  in  KEY_SZ 
/internal  KeylDoard  Buffer 


/==  Routines  and  functions  of  driver  =============================== 
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St  rat 

proc 

far 

; Strategy  routine 

mov 

cs:db  ptr, bx 

; Store  address  of  data  block  in  the 

mov 

cs:db_ptr+2,  es 

/Variable  DB_PTR 

ret 

/back  to  caller 

St  rat 

endp 

intr 

proc 

far 

/Interrupt  routine 

push 

ax 

/Store  registers  on  the  stack 

push 

bx 

push 

cx 

push 

dx 

push 

di 

push 

si 

push 

bp 

push 

ds 

push 

es 

pushf 

/store  also  the  flag  register 

push 

cs 

/Set  data  segment  register 

pop 

ds 

/Code  is  identical  here  with  data 

les 

di,dword  ptr  db_ptr; Address  of  data  block  to  ES:DI 

mov 

bl, es: [di+cmd  fid]  ;Get  command-code 

arp 

bl,num  cmd 

;is  command-code  permitted? 

jle 

bc_ok 

/YES  ~>  bc_ok 

mov 

ax,8003h 

/Code  for  "unknown  Command" 

jmp 

short  intr_end 

/back  to  caller 

; —  Command-Code  was 

o.k.  — >  Execute  command  - 

bc_ok : 

shl 

bl,  1 

/Calculate  pointer  in  jump  table 

xor 

bh,  bh 

/erase  BH 

call 

[fkt  tab+bx] 

/Call  function 

les 

di^dword  ptr  db  ptr; Address  of  the  data  block  to  ES:DI 

1 

Execution  of  the 

function  completed  - 

intr_end 

label  near 

or 

ax, OlOOh 

/Set  finished-bit 

mov 

es: [di+status] ,ax  ;store  everything  in  the  status  field 

popf 

/Restore  flag  register 

pop 

es 

/Restore  other  registers 

pop 

ds 

pop 

bp 

pop 

si 

pop 

di 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

ret 

/back  to  caller 

intr 

endp 

dummy 

proc 

near 

/This  routine  does  nothing 

xor 

ax,  ax 

/Erase  busy-bit 

ret 

/back  to  caller 
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dummy  endp 


no_sup  proc 

mov 

ret 

no  sup  endp 

near 

ax,8003h 

;This  routine  called  for  all  functions 
; which  should  really  not  be  called 
/Error:  Command  not  recognized 
/back  to  caller 

store_c  proc 

near 

/stores  a  character  in  the  internal 
/keyboard  buffer 
/Input:  AL  *=  character 
/  BX  =  Position  of  the  character 

mov 

[bx+key  bu|,al 

/store  character  in  internal  buffer 

inc 

bl 

/increment  pointer  to  End 

cmp 

bl,KEY  SZ 

/End  of  buffer  reached  ? 

jne 

store_e 

/NO  — >  STORE_E 

xor 

bl,bl 

/new  end  is  the  beginning  of  buffer 

store_e:  ret 

/back  to  caller 

store_c  endp 

read  proc 

near 

/read  a  certain  number  of  characters 
/from  the  keyboard  to  a  buffer 

mov 

cx,es: [di+num  db] 

/read  number  of  characters 

jcxz 

read_e 

/test  if  equal  to  0 

les 

di,es: [di+b_adr] 

/Address  of  character  buffer  to  ES:DI 

cld 

/on  STOSB  count  up 

mov 

si, key  a 

/Pointer  to  next  character  in  KEY_SZ 

mov 

bx,  key  e 

/Pointer  to  last  character  in  KEY_SZ 

read  1 :  cmp 

si,bx 

/other  characters  in  keyboard  buffer? 

jne 

read_3 

/YES  — >  READ_3 

read_2:  xor 

ah,  ah 

/Function  number  for  reading  is  0 

int 

16h 

/Call  BIOS  Keyboard- interrupt 

call 

store  c 

/Store  characters  in  internal  buffer 

cmp 

al,0 

/test  if  extended  code 

jne 

read  3 

/no  — >  READ_3 

mov 

al,ah 

/Extended  Code  is  in  AH 

call 

store_c 

/ store 

read  3:  mov 

al, [si+key  bu] 

/read  character  from  keyboard  buffer 

stosb 

/transmit  to  buffer  of  calling  funct. 

inc 

si 

/Increment  pointer  to  next  character 

cmp 

si,  KEY  SZ 

/End  of  buffer  reached? 

jne 

read_4 

/NO  ~>  READ_4 

xor 

si,  si 

/next  character  is  the  first  character 
/in  the  keyboard  buffer 

read  4 ;  loop 

read  1 

/repeat  until  all  characters  read 

mov 

key_a, si 

/Store  position  of  the  next  character 
/in  the  key  board  buffer 

mov 

byte  ptr  key_e,bl 

/Store  position  of  the  last  character 
;in  the  key  board  buffer 

read  e:  xor 

ax,  ax 

/everything  o.k. 

ret 

/back  to  caller 
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read  end^ 

read_b  proc 

near 

/read  the  next  character  from  the 
/key  board  but  leave  in  the  buffer 

mov 

int 

je 

ah,l 

16h 

read_pl 

/Function  number  for  BlOS-interrupt 
/call  BIOS  Keyboard-interrupt 
/no  character  present  — >  READ_P1 

mov 

xor 

ret 

es: [di+13],al 
ax,  ax 

/store  character  in  data  block 
/everything  o.k. 

/back  to  caller 

read_pl  label 

near 

mov 

ret 

ax,0100h 

/Set  busy-bit  (no  character) 

/back  to  caller 

read  b  endp 

del_in_b  proc 

near 

/erase  input  buffer 

mov 

int 

je 

ah,  1 

16h 
del  e 

/Still  characters  in  the  buffer? 

/Call  BIOS  key  board  interrupt 
/ no  character  in  the  buffer  — >  END 

xor 

int 

jmp 

ah,  ah 

16h 

short  del_in_b 

/Remove  character  from  buffer 
/Call  BIOS  key  board  interrupt 
/Test  for  additional  characters 

del_e:  xor 

ret 

ax,  ax 

/everything  o.k. 

/back  to  caller 

del_in  b  endp 

write  proc  near 

/write  a  specified  number  of 
/characters  on  the  display  screen 

mov 

jcxz 

Ids 

cld 

cx,es: [dl+num_db] 
write  e 

si,es: [di+b_adr] 

/Number  of  characters  read 

/test  if  equal  to  0 

/Address  of  character-buffer  to  DS:SI 

/on  LODSB  increment  count 

mov 

int 

ah,  3 

16h 

/read  current  display  page 
/Call  BIOS  Video-interrupt 

mov 

ah,14 

/Function  number  for  BIOS  interrupt 

write_l :  lodsb 

int  lOh 
loop  write  1 

/read  character  to  be  output  to  AL 
/call  BIOS  Video-interrupt 
/repeat  until  ail  characters  output 

write  e:  xor 

ret 

ax,  ax 

/everything  o.k. 

/back  to  caller 

write  endp 

init  proc 

near 

/Initialization  routine 

mov  word  ptr  es: [di+end_adr] , offset  init  ;Set  End-Address  of 
mov  es: [di+end_adr+2] , cs  ;the  driver 
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xor  ax, ax  ; everything  o.k. 

ret  ;back  to  caller 

init  endp 


code  ends 
end 


The  header  of  this  driver  describes  a  character  device  driver  which  handles  both  the 
standard  input  device  (keyboard)  and  the  standard  output  device  (monitor).  After 
linking  it  into  the  system,  setting  the  two  bits  in  the  device  attribute  calls  this 
driver  on  all  function  calls  previously  handled  by  the  CON  driver.  Like  any  other 
driver,  this  driver  has  a  strategy  routine  and  an  interrupt  routine.  The  former  stores 
the  address  of  the  datablock  in  the  variable  DB  JPTR. 

The  interrupt  routine  saves  the  contents  of  all  registers  which  will  be  changed  by  it 
on  the  stack  and  gets  the  routine  number  to  be  called  from  the  data  block.  It  then 
checks  whether  CONDRV  supports  this  function.  If  not,  it  jumps  directly  to  the 
end  of  the  interrupt  routine  and  sets  the  proper  error  code  in  the  status  field  of  the 
request  header  which  was  passed  to  the  routine.  Then  it  restoes  the  registers  which 
were  saved  on  the  stack  and  returns  control  to  the  calling  DOS  function. 

For  any  of  the  functions  that  are  supported  by  the  device  driver,  the  offset  address 
of  a  routine  to  handle  a  particular  function  is  determined  from  the  table  labeled 
FKT_TAB.  Notice  that  the  routines  named  DUMMY  and  NO_SUP  appear  several 
times.  DUMMY  is  for  all  functions  which  apply  only  to  block  device  drives  and 
therefore  are  not  used  in  this  driver.  The  DUMMY  routine  clears  the  AX  register 
and  sets  the  BUSY  bit  in  the  status  word.  The  NO_SUP  routine  handles  any 
functions  which  cannot  be  used  since  the  drive  attribute  for  CONDRV  does  not 
support  these  functions. 

The  STORE__C  routine  can  be  accessed  from  the  lower  level  routines  in  this  driver. 
Its  purpose  is  to  store  a  character  in  the  internal  keyboard  buffer  of  the  driver.  The 
driver  really  shouldn't  have  this  buffer  available  since  BIOS  (whose  functions  are 
used  by  the  driver  to  read  characters  from  the  keyboard)  also  has  such  a  buffer.  The 
problem  is  that  the  BIOS  always  returns  two  characters  when  pressing  a  key  with 
extended  codes  (cursor  keys,  function  keys  etc.).  If  the  higher  level  functions  of 
DOS  only  ask  for  one  character  at  a  time  from  CONDRV,  the  second  character 
must  not  be  lost.  It  should  be  stored  in  a  buffer  and  delivered  to  DOS  by  the  read 
function  on  the  next  call.  This  is  STORE__C’s  task. 

Reading  characters 

The  next  routine  is  the  READ  function.  It  obtains  the  number  of  characters  to  be 
read  from  the  request  header  passed  by  DOS.  If  it  is  0,  the  routine  is  terminated 
immediately.  If  not,  then  a  loop  starts  which  executes  once  for  every  character  read. 
It  first  tests  for  characters  still  stored  in  the  internal  keyboard  buffer.  If  so,  a 
character  is  passed  to  the  buffer  of  the  calling  function.  If  no  additional  character 
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exists  in  the  keyboard  buffer,  function  0  of  the  BIOS  keyboard  interrupt  16H 
inputs  a  character  from  the  keyboard.  This  character  is  also  passed  to  the  internal 
keyboard  buffer.  If  it's  an  extended  keycode,  it  is  divided  into  two  characters.  The 
next  step  removes  a  character  from  the  internal  keyboard  buffer  and  passes  the 
character  to  the  buffer  of  the  calling  function.  The  process  repeats  until  all 
characters  requested  have  been  passed  to  DOS.  Then  the  routine  ends. 

The  higher  level  DOS  functions  also  call  the  function  named  READ_P.  It  tests 
whether  a  character  was  entered  from  the  keyboard.  If  not,  it  sets  the  BUSY  bit  in 
the  status  field  of  the  request  header  passed  by  DOS,  and  returns  to  the  calling 
function.  If  a  character  was  entered  without  having  been  read,  the  driver  reads  this 
character  and  passes  it  to  the  calling  DOS  function  in  the  request  header,  and  resets 
the  busy  bit.  The  character  remains  in  the  keyboard  buffer,  and  on  a  subsequent  call 
of  the  read  function,  it  is  again  passed  to  DOS.  To  test  the  availability  of  a 
character,  the  READ_P  function  uses  function  1  of  the  BIOS  keyboard  interrupt 
16H. 

The  function  DEL_IN_B  also  gets  called  by  the  higher  level  DOS  functions. 
DEL_IN_B  deletes  the  contents  of  the  keyboard  buffer.  It  removes  characters  from 
the  buffer  using  function  0  of  the  BIOS  keyboard  interrupt  until  function  1 
indicates  that  no  more  characters  are  available.  This  ends  the  function  and  it  returns 
to  the  calling  function  after  the  busy  bit  is  reset 

Writing  characters 

WRITE  takes  the  number  of  characters  from  a  buffer  passed  by  DOS  and  displays 
the  characters  on  the  screen.  This  routine  uses  function  OEH  of  the  BIOS  video 
interrupt.  Once  all  characters  have  been  displayed,  it  sets  the  BUSY  bit  in  the 
status  field  and  ends  the  function.  This  function  also  executes  when  the  higher 
level  DOS  functions  call  the  Write  and  Verify  functions. 

Initialization 

The  last  function,  the  initialization  routine,  is  called  first  by  DOS.  Since 
CONDRV  does  not  initialize  variables  and  hardware,  the  routine  simply  enters  the 
driver's  ending  address  into  the  passed  request  header.  The  routine  returns  its  own 
starting  address  since  it  will  never  be  called  again,  and  is  the  end  of  the  chain  of 
drivers. 

In  its  current  form  the  driver  has  little  use,  since  it  uses  only  those  functions 
already  available  to  the  CON  driver  of  DOS.  It  would  be  more  practical  if  an 
enhanced  driver  like  ANSI.S  YS  were  developed,  through  which  screen  design  could 
be  more  tightly  controlled.  For  example,  it's  possible  that  such  a  driver  would 
have  complete  windowing  capability  which  could  be  accessed  from  any  program, 
in  any  programming  language. 

The  following  block  device  driver  creates  a  160K  RAM  disk: 
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*  RAMDISK  * 


Task  :  This  Program  is  a  Driver  for  a  160KB 

RAM-Disk. 


Author  :  MICHAEL  TISCHER 

developed  onm  :  8.4.87 

last  Update  ;  9.21.87 


assembly  :  MASM  RAMDISK; 

LINK  RAMDISK; 

EXE2BIN  RAMDISK  RAMDISK. SYS 


*  Call 

* 


:  Copy  into  Root  Directory,  enter  the  ccanmand  *, 
DEVICE=RAMDISK.sys  into  the  CONFIG.SYS  file  *, 
and  then  boot  the  System.  *, 

*********************************  ******** ********** 


code  segment 

assume  cs : code, ds: code, es: code, ssicode 


org 

0 

; Program  has  no  PSP  therefore  begin 

;at  the  offset  address  0 

cmd_fld 

equ  2 

; Offset  command  field  in  data  block 

status 

equ 

3 

;Offset  status  field  in  data  block 

num  dev 

equ 

13 

; Offset  number  of  supported  devices 

changed 

equ 

14 

; Offset  medium  changed? 

end_adr 

equ 

14 

;Offset  driver  end-aAdr.  in  data  block 

b_adr 

equ 

14 

;Offset  buffer  address  in  data  block 

num_cmd 

equ 

16 

;the  functions  0-16  are  supported 

num  db 

equ 

18 

; Offset  number  in  data  block 

bpb_adi' 

equ 

18 

; Offset  Address  of  BPB  of  the  media 

sector 

equ 

20 

;Offset  first  sector  number 

dev_des 

* ““  03^3 

equ 

22 

;Offset  device-description  of  RAM-Disk 

erst_b 

equ 

this  byte 

;this  is  the  first  byte  of  the  driver 

; —  Header  of  the  Device-Driver 


dw  -1,-1 

dw  0100100000000000b 


; Connect ion  to  next  driver 
; Driver  attribute 


dw 

offset 

strat 

; Pointer  to  strategy  routine 

dw 

offset 

intr 

; Pointer  to  interrupt  routine 

db 

1 

;a  device 

is  supported 

db 

7  dup 

(0) 

; these  bytes  give  the  name 

-  Jump  Table  for 

the  individual 

functions  - 

:  tab  dw 

offset 

init 

; Function 

0:  Initialization 

dw 

offset 

med  test 

; Function 

1;  Media  Test 

dw 

offset 

get  bpb 

/Function 

2:  created  BPB 

dw 

offset 

read 

; function 

3:  direct  reading 

dw 

offset 

read 

/Function 

4 :  Read 

dw 

offset 

dummy 

/Function 

5:  Read,  remain  in  Buffer 

dw 

offset 

dummy 

/Function 

6:  Input-Status 

dw 

offset 

dummy 

/Function 

7:  Erase  Input-Buffer 

dw 

offset 

write 

/Function 

8:  Write 

dw 

offset 

write 

/Function 

9:  Write  &  Verification 

dw 

offset 

dummy 

/Function 

10:  Output -Status 

dw 

offset 

dummy 

/Function 

11:  Erase  Output-Buffer 

dw 

offset 

write 

/Function 

12:  direct  Write 

dw 

offset 

dummy 

/Function 

13:  Open  (after  DOS  3.0) 

dw 

offset 

dummy 

/Function 

14:  Close 
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dw 

offset  no_rem 

/Function  15;  changeable  Medium? 

dw 

offset  write 

/Function  16:  Output  until  Busy 

db_ptr 

dw 

(?)/(?) 

/Address  of  the  data  block  passed 

rd_seg 

dw 

(?) 

/RD__SEG:0000  beginning  of  the  RAM-Disk 

bpb_ptr 

dw 

offset  bpb,  (?) 

/Accepts  the  address  of  the  BPB 

boot_sek 

db 

3  dup  (0) 

/normally  a  jump  command  to  the  boot 
/Routine  is  stored  here 

db 

"MITI  1.0" 

/Name  of  creator  &  version  number 

bpb 

dw 

512 

/512  bytes  per  sector 

db 

1 

/I  Sector  per  cluster 

dw 

1 

/I  reserved  sector  (boot-sector) 

db 

1 

/I  File-Allocation-Table  (FAT) 

dw 

64 

/maximum  64  entries  in  root  directory 

dw 

320 

/total  of  320  sectors  »  160  KB 

db 

OFEh 

/Media  descriptor  (1  Side  with  40 
/Tracks  of  8  sectors  each) 

dw 

1 

/every  FAT  occupies  one  sector 

; —  the  Boot  routine  not  included  since  a  System  can  not - 

; —  be  booted  frcMn  a  RAM-Disk 

vol_name  db  "RAMDISK  "  ;the  actual  volume-name 

db  8  /Attribute,  defines  volume-name 


Routines  and  functions  of  the  Driver 


strat  proc  far 


/Strategy  routine 


mov  cs : db_pt  r , bx 
mov  cs:db_pt r+2,  es 


/Store  address  of  the  data  block 
/in  the  Variable  DB_PTR 


ret 

endp 


/back  to  caller 


intr  proc  far 

push  ax 
push  bx 
push  cx 
push  dx 
push  di 
push  si 
push  bp 
push  ds 
push  es 
pushf 

push  cs 
pop  ds 


/Interrupt  routine 

/Store  registers  on  the  stack 


/also  store  flag  register 

/Set  data  segment  register 
/Code  identical  with  data  here 


les  di,dword  ptr  db_ptr/ Address  of  data  block  to  ES:DI 
mov  bl , es : [ di + cmd_f Id  1  / Get  command-code 
cmp  bl,num_cmd  /is  command-code  permitted? 

jle  bc_ok  /YES  — >  bc_ok 


mov  ax,8003h 
jmp  short  intr_end 


/Code  for  "unknown  Command" 
/back  to  caller 


/ —  Corranand-Code  was  o.k.  — >  Execute  Co/ranand 


bc_ok:  shl  bl,l  /Calculate  pointer  in  juitqp  table 

xor  bh, bh  /erase  BH 

call  [fkt_tab+bx]  /Call  function 
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; —  Execution  of  the  function  completed 


intr_end  label  near 

push  cs  ;Set  data  segment  register 

pop  ds  /Code  is  identical  with  data  here 

les  di,dword  ptr  db_ptr; Address  of  the  data  block  to  ES:DI 
or  ax, OlOOh  /Set  finished-bit 

mov  es: [di+statusj ,ax  /store  everything  in  the  status  field 


intr 


init 


popf 

/Restore  flag  register 

pop 

es 

/restore  other  registers 

pop 

ds 

pop 

bp 

pop 

si 

pop 

di 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

ret 

/back  to  caller 

endp 

proc 

near 

/Initialization  routine 

/ —  the  following  code  is  overwritten  after  the  installation  - 
/—  by  the  RAM-Disk 


/ —  determine  Device  designation  of  the  ElAM-Disk  — 


mov  ah,30h 
int  21h 
cmp  al,3 
jb  prinm 


/Sense  DOS  Version  with  function  30(h) 
/of  DOS-interrupt  21 (h) 

/is  it  Version  3  or  higher  ? 

/YES  ~>  PRINM 


mov  a 1 , es : [ d i +dev_des ] 
add  al,'*A'' 
mov  im_ger,al 

prinm:  mov  dx, offset  initm 

mov  ah, 9 
int  21h 


/Get  device  designation 

/convert  to  letters 

/store  in  installation  message 

/Address  of  installation  message 
/output  function  number  for  string 
/Call  DOS-interrupt 


/ —  Calculate  Address  of  the  first  byte  after  the  RAM-Disk  — 
/ —  and  set  as  End  Address  of  the  Driver 


mov  word  ptr  es: [di+end_adr] , offset  ramdisk+SOOOh 

mov  ax, cs  /Size  of  RAM-Disk  is  32KB  plus 

add  ax, 2000h  /2  *  64KB 

mov  es: [di+end_adr+2]  ,ax 

mov  byte  ptr  es; [di+num_dev] ,  1  /I  device  supported 

mov  word  ptr  es; [di+bpb_adr] , offset  bpb_ptr  /Address  of  the 
mov  es; [di+bpb_adr+2] ,ds  /BPB-Pointer 


mov  ax, cs 

mov  bpb_pt  r-*-  2 ,  ds 

mov  dx, offset  ramdisk 

mov  cl , 4 

shr  dx,  cl 

add  ax, dx 

mov  rd_seg,  ax 


/Segment  address  of  RAM-Disk  beginning 
/Segment  address  of  BPB  in  BPB-Pointer 
/calculate  to  offset  address  0 
/Divide  offset  address  by  16  and  thus 
/convert  into  segment  address 
/add  the  two  segment  addresses 
/and  store 


/ —  Create  Boot -Sector 


mov  es,ax  /transfer  segment  address  to  ES 

xor  di,di  /Boots,  begins  with  the  1.  byte  of  RD 
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mov  si, offset  boot_sek  ;Address  of  the  boot-sector  in  memory 
mov  cx, 15  ;only  the  first  15  words  are  used 

rep  movsw  ;copy  boot-sector  into  RAM-Disk 

; —  Create  FAT  - 

mov  dl,512  ;FAT  begins  with  the  byte  512  of  RD 

mov  al,0FEh  /Write  media-descriptor  into  the  first 

stosb  ;byte  of  the  FAT 

mov  ax,0FFFFH  /Store  code  for  bytes  2  and  3  of  FAT 

stosw  ;in  FAT 

mov  cx, 236  /remaining  236  words  occupied  by  FAT 

inc  ax  /Set  AX  to  0 

rep  stosw  /Set  all  FAT-entries  to  unoccupied 

/ —  Create  Root  Directory  with  Volume-Name  - 

mov  di,1024  /Root  Directory  starts  in  3rd  Sector 

mov  si, offset  vol_name  /Address  of  volume-name  in  memory 
mov  cx, 6  /the  volume-name  is  6  words  long 

rep  movsw  /Copy  volume-name  into  RD 

mov  cx, 1017  /Fill  the  rest  of  the  directories  in 

xor  ax, ax  /Sectors  2,  3,  4  and  5  with  zeros 

rep  stosw 

xor  ax, ax  /everything  o.k. 

ret  /back  to  caller 

init  endp 


dummy 

proc 

near 

/This  Routine  does  nothing 

xor 

ret 

ax,  ax 

/Erase  busy-bit 
/back  to  caller 

dummy 

endp 

med_test 

proc 

near 

/Media  of  RAM-Disk 
/cannot  be  changed 

mov 

xor 

ret 

byte  ptr 
ax,  ax 

es: [di+changed] ,  1 

/Erase  busy-bit 
/back  to  caller 

med  test 

endp 

get  _bpb 

proc 

near 

/Pass  address  of  BPS  to  DOS 

mov 

mov 

word  ptr 
word  ptr 

es: [di+bpb_adr] , of fset  bpb 
es: [di+bpb  adr+2],ds 

xor 

ret 

ax,  ax 

/Erase  busy-bit 
/back  to  caller 

get_bpb 

endp 

no_rem  proc  near  /Media  of  RAM-Disk  cannot  be  changed 

mov  ax, 20  /Set  busy-bit 

ret  /back  to  caller 
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endp 


write  proc  near 


xor  bp,  hp 
jmp  short  move 


write  endp 


; Transmission  DOS  — >  RAM-Disk 
;Copy  data 


read  proc  near 

mov  bp, 1 
read  en<4> 


; Transmission  RAM-Disk  — >  DOS 


—  MOVE:  Move  a  certain  number  of  sectors  between  RD  and  DOS 

—  Input  :  BP  =  0  :  transmit  from  DOS  to  RD  (Write) 


1 

:  transmit  from  RD 

to  DOS  (Read) 

; —  Output  : 

none 

; —  Registers 

:  AX,  BX,  CX,  DX, 

SI,  DI,  ES,  DS  and  FLAGS  are  changed 

; —  Info 

Information  required  (number,  first  sector) 

;  — 

is  taken  from  the 

data  block  passed  by  DOS 

move 

proc 

near 

mov 

bx, es : [di+num  db] 

; Number  of  sectors  read 

mov 

dx, es : [di+Sector ] 

; Number  of  first  sector 

les 

di,es: [di+b_adrl 

/Address  of  buffer  to  ES:DI 

move  1 : 

or 

bx,bx 

/More  sectors  to  read  ? 

je 

move_e 

/No  more  sectors  — >  END 

mov 

ax,dx 

/Sector  number  to  AX 

mov 

cl, 5 

/Calculate  number  of  paragraphs 

shl 

ax,  cl 

/ (Segment  units)  by  Multiplication 

add 

ax,cs:rd_seg 

/with  32,  add  to  Segment  start  of  RD 

mov 

ds,ax 

/transmit  to  DS 

xor 

si,  si 

/Offset  address  is  0 

mov 

ax,bx 

/Number  of  sectors  to  be  read  to  AX 

cmp 

ax, 128 

/more  than  128  sectors  to  read 

jbe 

move  2 

/NO  — >  read  all  sectors 

mov 

ax, 128 

/YES  — >  read  128  sectors  (64  KB) 

move  2: 

sub 

bx,  ax 

/subtract  number  of  sectors  read 

add 

dx,ax 

/add  to  sectorsto  be  read  next 

mov 

ch,al 

/Number  sect,  to  be  read  *  256  words 

xor 

cl,  cl 

/Set  Lo-byte  of  word-counter  to  0 

or 

bp,  bp 

/Should  be  read  ? 

jne 

move_3 

/NO  — >  M0VE_3 

mov 

ax,es 

/Store  ES  in  AX 

push  ds 

/Store  DS  on  the  stack 

pop 

es 

/read  ES 

mov 

ds,ax 

/ES  and  DS  are  reversed  now 

xchg  si,di 

/exchange  SI  and  DI 

move  3: 

rep 

movsw 

/copy  data  into  DOS-buffer 

or 

bp,  bp 

/read  ? 

jne 

move  1 

/NO  — >  maybe  other  sectors  to  copy 

mov 

ax,  es 

/Store  ES  in  AX 

push  ds 

/Store  DS  on  the  stack 

pop 

es 

/  read  ES 

mov 

ds,  ax 

/ES  and  DS  have  been  exchanged 

xchg 

si,  di 

/exchange  SI  and  DI  again 

jmp 

short  move_l 

/additional  sectors  to  copy 

move  e: 

xor 

ax,  ax 

/everything  o.k. 

ret 

/back  to  caller 

endp 
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; —  RAM-Dlsk  starts  here  - 

if  ($-erst_b)  mod  16  ;must  start  on  a  memory  address 

org  ($-erst_b)  +  16  -  (($-erst_b)  mod  16)  ;  divisible  by  16 
endif 

ramdisk  equ  this  byte 

initm  db  "****  160  KB  RAMDISK  as  Device” 
im_ger  db  " ? ” 

db  installed  (c)  1987  by  MICHAEL  TISCHER$",13,10,10 


code  ends 
end 

This  driver  is  similar  to  the  CONDRV  driver.  The  biggest  difference  between  the 
two  lies  in  the  functions  which  each  supports. 

Note:  The  initialization  routine  INIT  here  is  more  comprehensive  than  the 

CONDRV  initialization  routine,  and  remains  in  memory  after  the  end 
of  execution  even  though  it  is  no  longer  needed.  You’ll  see  why  this 
is  so  in  the  paragraph  below  entitled  "The  INIT  routine". 

First,  this  routine  finds  the  DOS  version  number  using  function  30H.  If  the 
version  number  equals  or  is  greater  than  3,  the  request  header  passed  by  DOS 
contains  the  device  designation  of  the  RAM  disk.  The  system  reads  the 
designation,  changes  it  to  a  character  and  places  the  character  into  the  installation 
message.  DOS  function  09H  is  used  to  display  this  message  on  the  screen. 

Next,  the  program  computes  the  ending  address  of  the  RAM  disk.  Since  the  actual 
data  area  of  the  RAM  disk  starts  immediately  after  the  last  routine  of  this  driver, 
160K  is  added  to  the  program’s  ending  address.  Further,  the  address  of  a  variable 
(BPB_PTR)  containing  the  address  of  the  BIOS  parameter  block  is  passed  to  DOS. 
This  variable  describes  the  RAM  disk's  format.  In  this  case,  it  tells  DOS  that  the 
RAM  disk  uses  512  bytes  per  sector.  Each  cluster  is  made  up  of  one  sector  and 
only  one  reserved  sector  (the  boot  sector)  exists.  In  addition,  only  one  FAT  exists. 
Additional  information  indicates  that  a  maximum  of  64  entries  can  be  made  in  the 
root  directory  and  that  the  RAM  disk  has  320  sectors  available  (160K  of  memory). 
The  FAT  occupies  a  single  sector,  and  the  media  descriptor  byte  FEH  designates  a 
diskette  with  one  side  and  40  tracks  of  8  sectors  each. 

These  parameters  are  then  placed  into  the  request  header  of  DOS  and  the  segment 
address  of  the  data  area  of  the  RAM  disk  is  calculated  (which  the  driver  itself 
requires,  DOS  does  not  need  this  information). 

The  INIT  routine 

The  RAM  disk  must  now  be  formatted,  to  create  a  boot  sector,  FAT  and  a  root 
directory.  Since  these  data  structures  are  in  the  first  sectors  of  the  RAM  disk,  a 
normal  INIT  routine  (which  releases  its  memory  to  DOS),  would  overwrite  itself 
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with  these  data  structures  and  would  crash  the  system.  This  is  why  the 
initialization  routine  is  not  at  the  end  of  the  last  routine  of  the  driver,  which  would 
place  it  at  the  beginning  of  the  RAM  disk's  data  area. 

The  boot  sector  occupies  the  complete  first  sector  of  the  RAM  disk,  but  only  the 
first  15  words  are  copied  into  it  since  DOS  only  needs  these.  The  name  "boot 
sector”  is  actually  a  misnomer  here,  since  it's  impossible  to  boot  a  system  from  a 
RAM  disk. 

The  second  sector  of  the  RAM  disk  contains  the  FAT.  The  first  two  entries  are  the 
media  descriptor  byte  and  0  in  the  entries  that  follow.  These  zeros  indicate 
unoccupied  clusters  (an  empty  RAM  disk). 

The  last  data  structure  is  the  root  directory.  It  contains  no  entries  other  than  the 
volume  name. 

Remaining  routines 

This  concludes  the  work  of  the  initialization  routine  and  returns  the  system  to  the 
calling  function.  The  remaining  driver  routines  are  examined  in  order. 

The  DUMMY  routine  performs  the  same  task  as  the  routine  of  the  same  name  in 
the  CONDRV  driver. 

The  MED_TEST  routine  is  found  only  in  block  device  drivers.  This  routine 
informs  DOS  whether  or  not  the  medium  was  changed. 

The  next  routine,  GET3PB,  simply  passes  the  addresses  of  the  variables  which 
contain  the  address  of  the  BPB  of  the  RAM  disk  to  DOS,  as  the  initialization 
routine  had  already  done. 

NO__REM  allows  DOS  to  sense  whether  the  medium  (the  RAM  disk)  can  be 
changed.  You  cannot  change  a  RAM  disk,  so  the  program  sets  the  BUSY  bit  in 
the  status  field. 

The  two  most  important  functions  of  the  driver  perform  read  and  write  operations. 
As  in  CONDRV,  the  program  calls  Write  and  Verify  instead  of  the  normal  Write 
function,  since  no  data  error  can  occur  during  RAM  access.  The  routine  itself  does 
very  little;  it  loads  the  value  0  into  the  BP  register  and  jumps  to  the  MOVE 
routine.  The  READ  routine  performs  in  a  similar  manner,  except  that  it  loads  a  1 
into  the  BP  register. 

MOVE  itself  is  an  elementary  routine  for  moving  dala.  The  BP  register  signals 
whether  data  is  to  move  from  the  RAM  disk  to  DOS  or  in  the  opposite  direction. 
The  routine  receives  all  other  data  (the  DOS  buffer's  address,  the  number  of  the 
sectors  to  be  transferred  and  the  first  sector  to  be  transferred)  from  the  data  block 
passed  by  DOS.  See  the  comments  in  the  MOVE  routine  for  details  of  the 
piocedure. 
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Changes 

This  RAM  disk  can  of  course  be  enhanced.  If  you  have  enough  unused  memcHy, 
you  can  extend  the  size  of  the  RAM  disk  to  360K.  AT  owners  could  make  the 
RAM  disk  resident  beyond  the  1  megabyte  boundary.  In  this  case,  the  data  transfer 
between  DOS  and  the  RAM  disk  would  use  function  87H  of  interrupt  15H. 

The  clock  driver 

This  final  sample  driver  directly  accesses  the  battery  powered  clock  of  an  AT 
compute’.  It  offers  the  advantage  that  when  the  two  DOS  commands  DATE  and 
TIME  are  used,  the  date  and  time  are  passed  directly  to  the  battery  pow»%d  realtime 
clock.  Reading  the  date  and  time  reads  the  information  directly  ^m  the  memory 
locations  of  the  realtime  clock. 


*********************************************************************** 


•  * 
t 

.  ★ _ 

A  T  C  L  K 

★  ■ 

* . 

•  * 
t 

Task 

:  This  program  is  a  clock-driver  which  can  be 

t 

* 

•  ★ 

used  by  DOS  for  functions  which  access  date 

*• 

■  ★ 

and  time  on  the  battery  powered  clock 

* 

t 

«  * 

•  * _ 

of  the  AT. 

*; 

•  ★ 
t 

Author 

:  MICHAEL  TISCHER 

★  • 

•  ★ 

developed  on 

:  8.4.87 

★ « 

•  * 

•  ★ _ 

last  Update 

:  9.21.87 

*; 
^  ^  • 

•  ★ 

assembly 

:  MASM  ATCLK/ 

t 

* . 

•  * 
t 

LINK  ATCLK/ 

*• 

•  * 

■  ★ _ 

EXE2BIN  ATCLK  ATCLK. SYS 

*  • 

t 

.—*  • 

t 

« ★ 
t 

Call 

:  Copy  into  root  directory  place  the  command 

—  r 

*; 

.  * 

DEVI CE=ATCLK. SYS  in  the  CONFIG.SYS  file 

★  • 

•  ★ 
s 

and  then  boot  the  system. 

★  • 
# 

*************************  ************************  ***************** 
code  segment 

assume  cs : code, ds : code, es : code, ss : code 

org  0  /Program  has  no  PSP,  therefore 

/beginning  at  offset  address  0 


/=  Constants 


cmd_fld 

equ 

2 

/Offset 

ccxnmand-field  in  data  block 

status 

equ 

3 

/Offset 

status  field  in  data  block 

end_adr 

equ 

14 

/Offset 

driver  end-adr.  in  data  block 

num_db 

equ 

18 

/Offset 

number  in  data  block 

b_adr 

equ 

14 

/Offset 

buffer-address  in  data  block 

/ —  Header  of  Device-Driver 


dw  -1,-1 

dw  1000000000001000b 
dw  offset  strat 
dw  offset  intr 
db  •'$CLOCK  " 


/Connection  to  next  driver 
/Driver  attribute 
/Pointer  to  strategy  routine 
/Pointer  to  interrupt  routine 
/new  clock  driver 


db_j)tr  dw  (?),(?) 


/address  of  data  block  passed 


mon  tab  db  31 


/Table  with  number  of  days  in 
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february  db  28  ;the  months 

db  31,30,31,30,31,31,30,31,30,31 


;=“  Routines  and  functions  of  the  Driver 

St rat  proc  far  ; Strategy  routine 

mov  cs:db_ptr,bx  ; Record  address  of  the  data  block  in 

mov  cs:dbjptr+2,es  ;the  variable  DB_PTR 

ret  ;back  to  caller 


intr 


proc 

far  ; 

r interrupt  routine 

push 

ax  , 

rSave  registers  on  the  stack 

push 

bx 

push 

cx 

push 

dx 

push 

di 

push 

si 

push 

bp 

push 

ds 

push 

es 

pushf  , 

r Store  the  flag  register 

cld 

r increment  for  string  commands 

push 

cs 

rSet  data  segment  register 

pop 

ds  , 

rCode  is  identical  with  data  here 

les 

di,dword  ptr  db_ptri 

r Address  of  data  block  to  ES:DI 

mov 

bl, es: [di+cmd  fid]  , 

r  Get  comma  nd- code 

aip 

bl,4  i 

r Should  Time/Date  be  read? 

je 

ck  read  , 

?YES  -->  CK  READ 

cmp 

bl,8  ; 

r Should  Time/Date  be  written? 

je 

ck  write  ; 

rYES  ~>  CK_WRITE 

or 

bl,bl 

? should  the  driver  be  initialized 

jne 

unk_fkt  , 

rNO  — >  unknown  function 

jmp 

init 

; initialize  driver 

mov 

ax, 8003h 

;Code  for  "unknown  Command" 

; —  Function  Execution  completed  - 

label  near 

or 

ax, OlOOh 

;Set  finished-bit 

mov 

es:  [di+status] , ax  , 

,•  store  everything  in  status  field 

popf 

r Restore  flag  register 

pop 

es 

;  Restore  other  registers 

pop 

ds 

pop 

bp 

pop 

si 

pop 

di 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

intr 


ret 

endp 


;back  to  caller 
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ck_read  proc  near  ;Read  Time/Date  frcm  the  clock 

mov  byte  ptr  es:  [di+nuin_db] ,  6  ;6  bytes  are  passed 
les  di,es: [di+b_adr]  ;ES:DI  points  to  the  DOS-buffer 


mov  ah, 4 
Int  lAh 
call  date_ofs 
stosw 


;Read  function  number  for  Date 
;Call  BIOS  Time  interrupt 
; Change  Date  after  offset  to  1.1.1980 
; store  in  buffer 


mov  ah, 2 

int  lAh 

mov  bl , ch 

call  bcd_bin 

stosb 

mov  cl,bl 

call  bcd_bin 

stosb 

xor  al,al 

stosb 

mov  cl , dh 
call  bcd_bin 
stosb 


;Read  function  number  for  time 
;Call  BIOS  Time  interrupt 
; Store  hour  in  BL 
; convert  minutes 
; Store  in  buffer 
;Hour  to  CL 
; Convert  hour 
; Store  in  buffer 
; Hundredth  second  is  0 
; Store  in  buffer 
; Seconds  to  CL 
; Convert  seconds 
/Store  in  buffer 


xor  ax, ax  /everything  o.k. 

jmp  short  intr_end  /back  to  caller 


ck_read  endp 


ck_write  proc  near  /Write  Time/Date  into  clock 


mov 

byte  ptr  es:[di+num  db],6  /6  bytes  are  read 

les 

di,es: [di+b_adr] 

/ES:DI  points  to  the  DOS  buffer 

mov 

ax,es: [di] 

/Get  number  of  days  since  1.1.1980 

push 

ax 

/store  number 

call 

ofs_date 

/convert  into  a  date 

mov 

ch,19h 

/Year  begins  with  19.. 

mov 

ah,  5 

/Set  function  number  for  date 

int 

lAH 

/Call  BIOS  Time  interrupt 

mov 

al,es: [di+2] 

/Get  minute  from  buffer 

call 

bin  bed 

/convert  to  BCD 

mov 

cl,al 

/bring  to  CL 

mov 

al,es: [di+5] 

/Get  seconds  from  buffer 

call 

bin  bed 

/convert  to  BCD 

mov 

dh,al 

/bring  to  DH 

mov 

al,es: [di+3] 

/Get  hours  from  buffer 

call 

bin_bcd 

/convert  to  BCD 

mov 

ch,al 

/bring  to  CH 

xor 

dl,dl 

/no  summer  time 

mov 

ah, 3 

/Set  function  number  for  time 

int 

lAH 

/Call  BIOS  Time  interrupt 

/ —  Calculate  Day  of  the  Week 


xor 

dx,dx 

/Hl-word  for  division 

pop 

ax 

/Get  number  of  days  from  stack 

or 

ax,  ax 

/is  number  0? 

je 

nodiv 

/Yes  — >  bypass  division 

xor 

dx,dx 

;HI-word  for  division 

mov 

cx,7 

/week  has  seven  days 

div 

cx 

/divide  AX  by  7 

nodiv:  add 

dl,3 

/I. 1.80  was  a  Tuesday  (Day  3) 

emp 

dl,8 

/is  it  a  Sunday  or  Monday? 

jb 

nosomo 

;NO  — >  no  correction  necessary 

sub 

dl,cl 

/correct  value 

nosomo :  mov 

al,6 

/Location  6  in  RTC  is  day  of  week 

out 

70h,al 

/Address  to  RTC-address  register 
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mov 

al,dl 

;Day  of  the  week  to  AL 

out 

71h,al 

;Day  of  the  week  to  RTC-data  register 

xor 

ax,  ax 

; everything  o.k. 

jmp 

intr_end 

/back  to  caller 

ckjwrite  endp 

; — 

OFS  DATE: 

Convert  number  of  days  since  1.1.1980  into  date  - 

Input  :  AX  =  Number  of  days 

1  since  1.1.1980 

; — 

Output  : 

CL  -  Year, 

,  DH  -  Month  and  DL  =  Day 

; — 

Registers 

:  AX,  BX, 

CX,  DX, 

SI  and  FLAGS  are  changed 

; — 

Info 

:  For  conversion  of  Offsets  the  Array  MC»J  TAB 

is  used 

ofs 

date  proc 

near 

mov 

cl,  80 

/Year  1980 

mov 

dh,01 

/ January 

ly: 

mov 

bx,  365 

/Number  of  days  in  a  normal  year 

test 

cl, 3 

/is  year  a  leap  year? 

jne 

lyl 

/NO  — >  lyl 

inc 

bl 

/Leap  Year  has  one  day  more 

lyl: 

:  cmp 

ax,bx 

/another  year  passed? 

jb 

mo 

/NO  — >  Calculate  months 

inc 

cl 

/YES  — >  Increment  year 

sub 

ax,  bx 

/deduct  number  of  days  in  this  year 

jmp 

short  ly 

/calculate  next  year 

mo: 

mov 

bl,28 

/Days  in  February  in  a  normal  year 

test 

cl,  11b 

/is  the  year  a  leap  year? 

jne 

nolp2 

/NO  — >  nolp2 

inc 

bl 

/in  leap  year  February  has  29  days 

nolp2:  mov  february,bl 

/store  number  of  days  in  February 

mov 

si, offset 

mon  tab 

/Address  of  months  table 

xor 

bh,bh 

/every  month  has  less  than  256  days 

mol: 

:  mov 

bl,  [si] 

/Get  number  of  days  in  month 

cmp 

ax,  bx 

/another  month  passed? 

jb 

day 

/NO  — >  calculate  day 

sub 

ax,  bx 

/YES  — >  deduct  day  of  the  month 

inc 

dh 

/increnent  month 

inc 

si 

/SI  to  next  month  in  the  table 

jmp 

short  mol 

/calculate  next  month 

day; 

:  inc 

al 

/the  remainder  +  1  is  the  day 

call 

bin  bed 

/Convert  day  to  BCD 

mov 

dl,al 

/transmit  to  DL 

mov 

al,dh 

/transmit  month  to  AL 

call 

bin  bed 

/convert  to  BCD 

mov 

dh,al 

/move  to  DH 

mov 

al,  cl 

/move  year  to  AL 

call 

bin  bed 

/convert  to  BCD 

mov 

cl,al 

/move  to  CL 

ret 

/back  to  caller 

ofs_ 

date  endp 

;  — 

BIN  BCD:  Convert  Binary-Number  to  BCD  - 

; — 

Input  :  AL  =  Binary  value 

;  — 

Output  : 

AL  =  corresponding  BCD-value 

f  — 

Register  ; 

:  AX,  CX  and  FLAGS 

are  changed 

bin_ 

bed  proc 

near 

xor 

ah,  ah 

/prepare  16  bit  division 

mov 

ch,10 

/work  in  decimal  system 

div 

ch 

/divide  AX  by  10 

shl 

al,l 

/Shift  quotient  left  4  places 
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shl 

al,l 

shl 

al,l 

shl 

al,l 

or 

al,ah 

;0R  remainder 

ret 

;bacJc  to  caller 

bin_bcd 

endp 

DATE 

OFS: 

Convert  Date  in  number  of  days  since  1.1.1980  - 

; —  Input  :  CL  *=  Year,  DH  * 

Month  and  DL  =  Day 

; —  Output  : 

AX  *=  Number  of 

days  since  1.1.1980 

; —  Register 

AX,  BX,  CX,  DX,  SI  and  FLAGS  are  changed 

; —  Info 

For  conversion  of 

date,  the  Array  MON  TAB 

; — 

is  used 

date_ofs 

proc 

near 

call 

bed  bin 

/Convert  year  to  binary 

mov 

bl,al 

/transmit  to  BL 

mov 

cl,dh 

/transmit  month  to  CL 

call 

bed  bin 

/Convert  Month  to  binary 

mov 

dh,al 

/and  transmit  again  to  DH 

mov 

cl,dl 

/transmit  day  to  CL 

call 

bed  bin 

/convert  day  to  binary 

mov 

dl,al 

/and  again  transmit  to  DL 

xor 

ax,  ax 

/O  days 

mov 

ch,  bl 

/store  year 

dec 

bl 

/back  one  year 

year: 

cmp 

bl,80 

/counted  back  to  year  1980  ? 

jb 

monat 

/YES  — >  convert  month 

test 

bl,llb 

/is  year  a  Leap  year  ? 

jne 

nolpyr 

/NO  — >  NOLPYR 

inc 

ax 

/a  leap  year  has  one  more  day 

nolpyr: 

add 

ax, 365 

/add  days  of  year 

dec 

bl 

/back  one  year 

jmp 

short  year 

/process  next  year 

month: 

mov 

bl,28 

/Days  in  February  in  a  normal  year 

test 

ch, lib 

;is  current  year  a  Leap  Year? 

jne 

nolpyrl 

/NO  ~>  NOLPYRl 

inc 

bl 

/in  Leap  Year  February  has  29  days 

nolpyrl : 

mov 

february,  bl 

/store  in  Month  table 

xor 

ch,ch 

/every  month  has  less  than  256  days 

mov 

bx, offset  mon 

tab 

/Address  of  month  table 

monatl : 

dec 

dh 

/decrement  number  of  months 

je 

add  day 

/all  month  calculated  — >  TAG 

mov 

cl,  [bx] 

/Get  number  of  days  in  month 

add 

ax,  CX 

/add  to  total-days 

inc 

bx 

/BX  to  next  month  in  the  table 

jmp 

short  monatl 

/calculate  next  month 

add  day: 

add 

ax,  dx 

/add  current  day 

dec 

ax 

/deduct  one  day  (1.1.80  =  0) 

ret 

/back  to  caller 

date  ofs 

endp 

BCD 

BIN: 

Convert  BCD  to 

Binary  Number  - 

; —  Input  : 

CL  =  BCD-Value 

; —  Output  : 

AL  =  corresponding  binary  value 

; —  Register 

:  AX,  CX  and  FLAGS 

are  changed 

bcd_bin 

proc 

near 

/Convert  BCD-value  in  CL  to  binary 

/return  in  AL 

mov 

al,  cl 

/transmit  value  to  AL 

shr 

al,l 

/shift  4  places  right 

shr 

al,l 

shr 

al,l 
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shr 

al,l 

xor 

ah,  ah 

;Set  AH  to  0 

mov 

ch,10 

; process  in  decimal  system 

mul 

ch 

; multiply  AX  by  10 

mov 

ch,cl 

; transmit  CL  to  CH 

and 

ch, 1111b 

;Set  Hi-Nibble  in  CH  to  0 

add 

al,ch 

;add  AL  and  CH 

ret 

;back  to  caller 

bcd_bin  endp 


init  proc  near  ; Initialization  routine 

; —  the  following  code  can  be  overwritten  by  DOS  - 

; —  after  installation  of  the  clock 

mov  word  ptr  es: [di+end_adrl , offset  init  ;Set  end  address 
mov  es: [di+end_adr+2] ,cs  ;of  the  driver 

mov  ah, 9  ;Output  installation  message 

mov  dx, offset  initm  ;Address  of  the  text 

int  21h  ;Call  DOS  interrupt 

xor  ax, ax  ; everything  o.k. 

jmp  intr_end  ;back  to  caller 

initm  db  13,10,  ••****  ATCLK-Driver  installed,  (c)  1987  by" 
db  "  MICHAEL  TISCHER", 13, 10, "$" 

init  endp 


code  ends 
end 

The  basic  structure  of  this  driver  differs  from  the  other  drivers  in  that  it  calls  the 
individual  functions  directly,  not  through  a  table  of  their  addresses.  Since  it  only 
supports  functions  OOH,  04H  and  OSH,  it  can  test  the  function  numbers  passed  by 
DOS  directly.  If  any  other  function  occurs,  it  signals  an  error.  Besides  the  INIT 
routine,  which  only  sets  the  ending  address  of  the  driver  like  CONDRV,  the  driver 
only  has  the  Read  Time  and  Date  and  Write  Time  and  Date  functions. 

Time  routine 

The  TIME  routine  is  fairly  simple.  For  reading  the  clock,  the  routine  reads  the 
time  from  the  memory  locations  of  the  clock,  converts  the  time  from  BCD  to 
binary  format  and  then  passes  the  time  to  the  DOS  buffer.  For  setting  the  time, 
the  reverse  occurs:  The  routine  reads  the  time  from  the  DOS  buffer,  converts  the 
code  from  binary  to  BCD  format  and  writes  the  BCD  code  into  the  memory 
locations  of  the  clock. 

DOS  uses  the  same  format  for  indicating  time  as  the  clock:  Hour,  minute  and 
seconds  each  comprise  one  byte. 
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Date  routine 

The  DATE  routine  is  more  complicated.  While  the  clock  stores  day,  month  and 
year  as  one  byte  each,  date  enco^ng  by  DOS  is  the  number  of  days  since  January 
1, 1980.  This  number  must  be  converted  into  a  date  in  the  form  of  day,  month  and 
year  as  DOS  writes  the  time  and  date.  The  reverse  is  true  when  you  call  the  Read 
function:  the  clock  date  must  be  converted  into  the  number  of  days.  Let's  look  at 
how  this  is  done. 

The  conversion  routine  starts  with  the  year  1980.  January  1,  1980  (called 
NUMDAYS  from  here  on)  is  equal  to  the  value  0.  The  routine  tests  whether  this 
year  is  less  than  the  current  year.  If  so,  it  adds  the  number  of  days  in  this  year  to 
NUMDAYS,  adding  a  day  to  compensate  for  each  leap  year.  Then  it  increments  the 
year  and  tests  again  for  a  smaller  number  than  the  current  year.  This  loop  repeats 
until  it  reaches  the  current  year.  The  routine  then  computes  the  number  of  days  in 
the  current  year’s  month  of  February,  and  enters  this  month  into  a  table  which 
contains  the  number  of  days  for  each  month. 

In  the  next  step,  for  every  month  less  than  the  current  month,  the  routine  adds  the 
number  of  days  in  this  month  to  NUMDAYS.  Once  it  reaches  the  current  month, 
only  the  current  days  of  the  month  are  added  to  NUMDAYS.  The  end  result  is 
transferred  to  the  DOS  buffer  and  the  routine  terminates. 

Conversion  to  date  format 

Converting  NUMDAYS  into  a  date  operates  in  reverse.  The  routine  begins  with 
the  year  1980  and  tests  whether  the  number  of  days  in  this  year  is  less  than  or 
equal  to  NUMDAYS.  If  this  is  the  case,  the  year  is  incremented  and  the  number  of 
days  in  this  year  is  subtracted  from  NUMDAYS.  This  loop  is  repeated  until  the 
number  of  days  in  a  year  is  larger  than  NUMDAYS.  The  routine  then  computes 
the  number  of  days  in  the  current  year's  month  of  February,  and  enters  this  month 
into  the  table  of  Ae  months. 

January  starts  another  loop  which  tests  whether  the  number  of  days  in  the  current 
month  is  less  than  or  equal  to  NUMDAYS.  If  this  is  the  case,  the  month 
increments  and  the  routine  subtracts  the  number  of  days  from  NUMDAYS.  If  the 
number  of  days  in  a  month  is  larger  than  NUMDAYS,  the  loop  ends.  NUMDAYS 
must  only  be  incremented  enough  to  give  the  day  of  the  month  and  complete  the 
date. 

The  routine  then  converts  the  date  to  BCD  format  and  enters  the  date  in  the 
memory  locations  of  the  clock. 


6.12.10  CD-ROMs 

Soon  after  their  introduction  into  the  audio  world,  the  compact  disk  industry  began 
approaching  the  PC  market.  A  CD-ROM  drive  and  a  PC  form  an  interesting 
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combination.  The  compact  disk  medium  itself  is  read-only,  but  660  megabytes  of 
data  can  be  stored  in  the  form  of  text,  graphics,  etc. 

Many  publications  and  references  are  currently  available  on  CD-ROM,  such  as: 

•  Telephone  directories 

•  Books  in  Print 

•  The  Bible  in  various  translations 

•  The  English  translation  of  Pravda 

In  addition,  maps,  photographic  libraries,  public  domain  program  collections  and 
medical  databases  are  available  in  CD-ROM  format.  New  titles  are  being  published 
daily  in  this  growing  market. 

Why  CD-ROM? 

The  CD-ROM  has  a  clear  advantage  over  the  printed  medium.  Once  captured  and 
digitized,  information  can  be  processed  by  a  computer  in  whatever  form  the  user 
needs.  The  possibilities  appear  to  be  limitless,  considering  how  easy  it  is  to  read 
and  compare  information. 

Another  important  consideration  is  the  ease  of  access  for  many  users.  Load  the 
driver  software,  press  a  key  or  two,  and  the  information  is  on  the  screen  and  ready. 

You  can  buy  a  PC-compatible  CD-ROM  player  for  $800  to  $1,000  at  the  time  of 
this  writing.  These  players  are  available  as  either  external  or  internal  devices. 

Interfacing 

The  PC's  hardware  can  be  easily  interfaced  to  a  CD-ROM  player.  The  software 
may  encounter  some  problems,  however.  This  is  understandable,  since  DOS  was 
never  intended  to  support  these  devices.  This  subsection  shows  how  a  CD-ROM 
drive,  using  the  proper  drivers  and  utility  programs,  can  be  accessed  like  a  read¬ 
only  floppy  disk  drive.  This  information  may  not  be  of  immediate  use  to  you. 
However,  this  data  will  give  you  a  closer  look  into  the  world  of  the  device  driver 
and  operating  system  organization. 

This  book  mentioned  earlier  that  the  device  drivers  act  as  mediators  between  the 
disk  operating  system  and  the  external  devices  such  as  monitor,  printer,  disk  drives 
and  hard  disks.  DOS  differentiates  between  block  device  drivers  and  character  device 
drivers.  As  a  mass  storage  device  capable  of  reading  information  in  a  block  mode,  a 
CD-ROM  drive  would  normally  be  added  to  the  rest  of  the  system  through  a  block 
driver.  Here's  where  the  problem  begins:  DOS  makes  a  number  of  assumptions 
about  block  devices,  and  a  CD-ROM  drive  cannot  meet  the  criteria  of  these 
assumptions. 
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Memory  limitations 

In  versions  of  DOS  up  to  and  including  Version  3.3,  the  biggest  obstacle  to 
interfacing  with  a  block  driver  was  the  32  megabyte  limit  imposed  on  every 
volume  designated  as  a  block  device.  The  second  biggest  obstacle  is  the  lack  of  a 
file  allocation  table  (FAT)  on  a  CD-ROM.  Instead  of  the  FAT,  the  CD-ROM 
contains  a  form  of  data  table  into  which  the  starting  addresses  of  the  various 
subdirectories  and  files  are  recorded.  However,  DOS  still  demands  a  FAT  which  it 
can  at  least  read  during  driver  initialization. 

A  character  driver  works  better  for  implementing  a  CD-ROM  driver,  since  DOS 
makes  no  assumptions  about  the  structure  of  the  devices  connected  through 
character  drivers.  Even  character  drivers  are  powly  suited  for  communication  with  a 
CD-ROM  drive,  since  they  transmit  characters  one  at  a  time  instead  of  in  groups 
of  characters.  Another  disadvantage  is  the  need  for  a  name  (e.g.,  CON)  instead  of  a 
device  designation.  DOS  must  first  see  the  CD-ROM  driver  as  a  character  driver  to 
DOS  to  prevent  read  accesses  to  a  non-existent  FAT.  The  CONFIG.SYS  file 
supplies  the  name  of  the  device  during  the  system  booting  process. 

Configuring  the  CD-ROM 

The  manufacturer  usually  includes  CD-ROM  driver  software  with  the  CD-ROM 
drive  package.  A  driver  of  this  type  usually  has  a  name  such  as  SONY.SYS  or 
HITACHI.SYS,  depending  on  the  manufacturer. 

The  CONFIG.SYS  sequence  which  installs  this  driver  can  look  something  like 
this: 


DEVICE=HITACHI.SyS  /DiCDRl 

The  device  driver  selects  the  name  CDRl  as  the  name  of  the  CD-ROM  drive. 

After  executing  the  initialization  routine  from  DOS,  the  CD-ROM  is  treated  as  a 
block  driver  which  has  been  enhanced  with  a  few  special  functions  supporting  CD- 
ROMs.  However,  DOS  still  views  the  CD-ROM  player  as  a  character  driver:  DOS 
cannot  view  the  CD-ROM's  directory,  nor  can  it  directly  access  the  files  on  the 
CD-ROM. 

Driver  software  extensions 

To  overcome  this  obstacle,  many  CD-ROM  players  come  with  a  TSR  (Terminate 
and  Stay  Resident)  program  named  MSCDEX  (Microsoft  CD-ROM  Extension)  in 
addition  to  the  device  driver  software  (see  Chapter  8  for  information  on  TSR 
programs).  This  program  must  be  called  from  within  the  AUTOEXEC.BAT  file. 
The  name  of  the  CD  driver  can  be  passed  to  the  program  from  the  DOS  prompt,  as 
shown  in  the  following  example: 

MSCDEX  /D:CDR1 
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MSCDEX  first  opens  this  driver  through  the  DOS  OPEN  function  and  provides  it 
a  device  designation.  DOS  assumes  that  MSCDEX  is  a  device  on  a  remote 
network,  as  supported  by  DOS  in  Version  3.1. 

MSCDEX  brings  us  closer  to  the  solution,  since  DOS  handles  network  devices  as 
files  containing  more  than  32  megabytes.  These  devices  are  accessed  through 
redirection,  rather  than  direct  access  from  DOS.  The  resident  portion  of  MSCDEX 
interfaces  to  the  redirector,  and  intercepts  all  calls  to  the  rejector.  If  MSCDEX 
receives  a  call  addressed  to  the  CD-ROM  drive,  it  adapts  each  instruction  to  a  call 
applicable  to  the  CD-ROM  driver.  This  makes  a  perfect  connection  between  DOS 
and  the  CD-ROM  drive,  while  still  allowing  access  to  subdirectories  and  files  at 
any  time. 


CD-ROM  access  through  MSCDEX  and  its  device  driver 
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6.13  DOS  Mass  Storage 

Many  tasks  performed  by  DOS  are  unseen  by  the  user.  This  is  why  some  users 
underestimate  the  complexity  of  DOS.  For  example,  DOS  requires  many  data 
structures  for  handling  a  mass  storage  device,  and  the  user  may  not  realize  this. 
This  section  looks  deeper  into  DOS  and  reveals  the  architecture  and  operation  of 
these  data  structures. 

From  the  user’s  viewpoint,  DOS  addresses  mass  storage  devices  as  volumes  where 
each  individual  volume  has  been  assigned  a  letter.  Roppy  disk  drives  are  identified 
by  the  letters  A  and  B,  while  the  letters  C  or  D  usually  identify  a  hard  disk.  A 
mass  storage  device  can  have  several  volumes.  This  division  into  several  volumes 
or  partitions  is  very  practical  for  hard  disks.  Partitions  on  a  floppy  diskette  don’t 
work  as  well  due  to  the  limited  amount  of  storage  space.  A  hard  disk  may  be 
divided  into  additional  partitions  if  UNIX  (or  XENIX)  is  used  in  addition  to  DOS. 
Each  of  the  two  operating  systems  then  has  its  own  volume  which  is  also 
designated  by  its  own  letter. 

Volume  names 

Each  volume  can  be  assigned  a  volume  name  when  created,  but  this  volume  name 
is  not  a  requirement.  The  DIR  command  lists  volume  names  when  they  are 
available.  Each  volume  has  its  own  root  directory,  which  can  contain  multiple 
subdirectories  and  files.  These  subdirectories  and  files  can  be  maintained  and 
manipulated  by  using  one  or  more  of  the  interrupt  21H  functions. 


Sectors 


DOS  subdivides  each  volume  into  a  series  of  sectors.  These  sectors  are  organized 
sequentially.  Each  sector  contains  a  specific  number  of  bytes  (usually  512)  and  is 
assigned  a  consecutive  number  beginning  with  sector  0.  Since  function  calls  with 
interrupt  21H  are  directed  to  files  rather  than  individual  sectors,  DOS  converts 
these  file  accesses  into  sector  accesses.  To  do  this,  DOS  uses  directories  and  a  data 
structure  known  as  the  FAT  (file  allocation  table),  which  you  read  about  earlier  in 
this  book.  After  the  desired  sector  number  has  been  determined,  control  is  passed  to 
the  device  driver  which  translates  this  sector  number  into  a  physical  address.  Mass 
storage  devices  such  as  floppy  and  hard  disks  are  divided  into  individual  tracks 
which  contain  a  certain  number  of  sectors.  In  addition  to  the  physical  sector 
number,  the  driver  must  also  determine  the  number  of  the  track  and  the  number  of 
the  read  head. 
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1 

Manufacturer *s  name,  device  driver,  boot  routine 

1 

First  file  allocation  table  (FAT) 

1 

One  or  more  copies  of  FAT 

1 

Root  directory  with  volume  names 

[ 

Data  register  for  files  and  subdirectories 

Mass  storage  device  structure 

As  mentioned  above,  evCTy  volume  is  divided  into  various  areas  containing  the 
various  DOS  data  structures  and  individual  files.  Since  the  size  of  the  individual 
areas  can  differ  depending  on  the  type  of  mass  storage  device  (and  the 
manufacturer),  every  volume  contains  a  boot  sector.  The  boot  sector  contains  all 
the  information  required  to  access  to  the  different  areas  and  data  structures.  DOS 
creates  this  sector  during  disk  formatting.  Boot  sectors  always  have  the  same 
structure  and  are  always  located  in  sector  0  so  that  DOS  can  find  and  interpret  it 
properly. 

The  following  illustration  shows  the  layout  of  the  boot  sector. 


00(h) 

Jump  command  to  boot  routine 
(E9XXX  or  EBxx90) 

(3  bytes) 

03(h) 

Manufacturer's  name  and  version  number 

(8  bytes) 

0B(h) 

Bytes  per  sector 

(1  word) 

0D(h) 

Sectors  per  cluster 

(1  byte) 

0E(h) 

Number  of  reserved  sectors 

(1  word) 

10(h) 

Number  of  FATs 

(1  byte) 

11(h) 

Number  of  entries  in  root  directory 

(1  word) 

13(h) 

Number  of  sectors  in  volume 

(1  word) 

15(h) 

Media  descriptor 

(1  byte) 

16(h) 

Number  of  sectors  per  FAT 

(1  word) 

18(h) 

Sectors  per  track 

(1  word) 

lA(h) 

Number  of  read/write  heads 

lC(h) 

Number  of  hidden  sectors 

lE(h)- 

IFF(h) 

BOOT  ROUTINE 

Boot  sector  layout 


Boot  sector 

The  name  boot  sector  comes  from  the  fact  that  DOS  boots  (i.e.,  starts)  from  it. 
DOS  is  loaded  and  started  from  disk — ^it  is  not  usually  stored  in  permanent  PC 
memory  (ROM).  After  you  turn  the  computer  on,  the  BIOS  takes  over  the  system 
initialization  and  loads  logical  sector  0  of  the  floppy  or  hard  disk  into  memory. 
Once  it  completes  its  work  the  BIOS  starts  execution  at  address  0. 
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The  boot  sector  always  contains  an  assembly  language  JUMP  instruction  at 
address  0.  After  execution  the  program  continues  at  a  location  further  into  the  boot 
sector.  This  instruction  can  be  either  a  normal  jump  instruction  or  a  "short  jump.” 
Since  the  field  for  this  jump  instruction  is  3  bytes  long,  but  a  "short  jump”  only 
requires  2  bytes,  a  NOP  (No  Operation)  instruction  always  follows  the  "short 
jump”  to  fill  in  the  extra  byte.  This  NOP  does  nothing.  A  series  of  fields  follow 
which  contain  certain  information  about  the  organization  of  the  media.  The  first 
field  is  8  bytes  long  and  contains  the  manufacturer's  name,  where  this  medium  was 
formatted,  as  well  as  the  DOS  version  number  which  performed  the  formatting. 
The  next  fields  contain  the  physical  format  of  the  media  (i.e.,  the  number  of  bytes 
per  sector,  the  number  of  sectors  per  track,  etc.)  and  the  size  of  the  DOS  data 
structures  stored  on  the  media.  Since  the  BIOS  and  DOS-BIOS  functions  represent 
the  lowest  level  of  access  to  disk  drives  and  hard  disks,  this  area  is  also  designated 
as  the  BIOS  parameter  block  (BPB).  Three  additional  fields,  which  can  provide 
additional  information  to  the  device  driver  about  the  media,  follow  the  BPB;  these 
three  fields  aren’t  used  directly  by  DOS. 

Bootstrap 

Next  comes  the  bootstrap  routine  to  which  the  jump  instruction  branches  at  the 
beginning  of  this  boot  sector.  It  handles  the  loading  and  starting  of  DOS  through 
the  individual  system  components  (see  Section  6.3). 

Several  reserved  sectors  may  follow  the  boot  sector.  These  reserved  sectors  can 
contain  additional  bootstrap  code.  The  numbers  of  these  sectors  are  recorded  in  the 
BPB  in  the  field  starting  at  address  OEH.  It  terminates  the  boot  sector  and  a  1  in 
this  field  indicates  that  no  additional  reserved  sectors  follow  the  boot  sector  (this  is 
the  case  for  most  PCs). 

In  order  for  DOS  to  add  new  files  or  enlarge  existing  files,  it  must  know  which 
sectors  of  the  media  are  still  available.  This  information  is  contained  in  a  data 
structure  called  the  FAT  (file  allocation  table)  which  is  immediately  adjacent  to  the 
media’s  reserved  area.  Each  entry  in  the  FAT  corresponds  with  a  certain  number  of 
logically  contiguous  sectors,  called  clusters,  on  the  media.  Location  ODH  of  the 
boot  sector  specifies  the  number  of  sectors  per  cluster  as  part  of  the  BIOS 
parameter  table.  Only  multiples  of  2  are  legal  values.  On  an  XT  hard  disk  this 
location  contains  the  value  8  (8  consecutive  sectors  form  a  cluster).  As  the 
following  table  demonstrates,  the  number  of  sectors  comprising  a  cluster  depends 
on  the  storage  medium. 


Device 

Sectors  per  cluster 

Sinqle  sided  disk  drive 

1 

Double  sided  disk  drive 

2 

AT  hard  disk 

4 

XT  hard  disk 

8 

The  reason  for  joining  several  sectors  into  a  cluster  is  derived  from  the  logic  used 
by  DOS  to  write  files  to  a  media.  It  disassembles  the  file  to  fit  the  pieces  into  the 
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sectors  which  are  still  available,  instead  of  selecting  adjoining  sectors  for  file 
storage.  This  process  slows  file  access  since  the  read/write  head  must  be 
repositioned  after  almost  every  read  function.  To  avoid  an  excessive  disassembly  of 
the  file,  DOS  gathers  several  sequential  sectors  on  the  media  into  a  cluster.  This 
ensures  that  at  least  the  sectors  of  a  cluster  contain  a  portion  of  a  file.  If  DOS 
didn't  use  clusters,  a  file  of  24  sectors  could  be  stored  in  many  separate  sectors, 
which  would  require  the  read/write  head  to  be  positioned  a  maximum  of  24  times 
to  read  the  entire  file.  The  cluster  principle  saves  a  lot  of  time,  since  the  file  is 
stored  in  6  clusters  and  the  read/write  head  only  has  to  be  repositioned  6  times. 

There  is  a  problem  however.  Since  a  file  is  assigned  at  least  one  cluster,  some 
storage  space  is  wasted.  Consid^  AUTOEXEC.BAT  which  is  usually  no  longer 
than  150  bytes.  Normally,  a  single  sector  could  contain  this  file  (and  still  waste 
almost  400  bytes),  but  AUTOEXEC.B AT  occupies  a  cluster  of  2048  bytes  on  an 
AT,  which  wastes  more  than  1.5K  of  hard  disk  space. 

Now  back  to  the  file  allocation  table: 

The  size  of  individual  entries  in  the  FAT  under  DOS  Versions  1  and  2  is  12  bits. 
For  DOS  Version  3  and  later,  the  size  of  an  entry  in  the  FAT  depends  on  the 
number  of  clusters:  if  a  volume  has  more  than  4,096  clusters,  then  each  FAT  entry 
is  16  bits;  otherwise  each  FAT  entry  is  12  bits.  The  number  of  bits  per  FAT  entry 
must  be  determined  before  file  access.  The  information  in  the  BIOS  parameter 
block  is  used  for  this  purpose.  The  total  number  of  sectors  in  the  volume  can  be 
found  starting  at  location  13H.  Divide  this  number  by  the  number  of  sectors  per 
cluster  to  obtain  the  number  of  clusters  in  the  volume. 

The  first  two  entries  of  the  FAT  are  reserved  and  have  nothing  to  do  with  the 
cluster  assignment  Depending  on  the  sizes  of  the  individual  entries,  24  bits  (3 
bytes)  or  32  bits  (4  bytes)  can  be  available.  The  first  byte  contains  the  media 
descriptor,  while  the  value  255  fill  in  the  other  bytes.  The  media  descriptor,  which 
is  also  stored  in  address  15H  of  the  BPB,  indicates  the  device  which  the  media  uses 
(for  example  a  diskette).  The  following  codes  are  possible: 


Code 

Device 

F8H 

Hard  disk 

F9H 

5.25”  disk  drive  (AT  only) 

2  sides,  80  tracks,  15  sectors 

FCH 

5.25”  disk  drive 

1  side,  40  tracks,  9  sectors 

FDH 

5.25”  disk  drive 

2  sides,  40  tracks,  9  sectors 

FEH 

5.25”  disk  drive 

1  side,  40  tracks,  8  sectors 

FFH 

5.25”  disk  drive 

2  sides,  40  tracks,  8  sectors 

This  shows  the  various  diskette  formats  which  DOS  supports  in  5.25”  diskettes. 
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Included  In  DOS  version 

o 

o 

1.10 

2.00 

2.00 

3.00 

Media  descriptor 

FE 

FF 

FC 

FD 

F9 

Number  of  read/write  heads 

1 

2 

1 

2 

2 

Number  of  tracks  per  head 

40 

40 

40 

40 

80 

Number  of  sectors  per  track 

8 

8 

8 

8 

8 

Number  of  bvtes  oer  sector 

512 

512 

512 

512 

512 

Number  of  sectors  per  cluster 

1 

2 

1 

2 

1 

Number  of  reserved  sectors 

1 

1 

1 

1 

1 

1 

1 

2 

2 

7 

Number  of  FATs 

2 

2 

2 

2 

2 

Number  of  sectors 

in  root  directory 

4 

7 

4 

7 

14 

Number  of  entries 
in  root  directory 

64 

112 

64 

112 

224 

Total  number  of  sectors 

320 

640 

360 

720 

2400 

Free  sectors  for  data 

313 

620 

351 

708 

2371 

Number  of  clusters 

313 

315 

351 

354 

2371 

160K 

320K 

(-» 

00 

o 

360K 

1.2Mea 

Total  file  capacity 

156. 5K 

315K 

175. 5K 

354K 

1.185Meg 

DOS  5.25"  diskette  formats 

You  may  have  wondered  why  the  individual  entries  of  the  FAT  are  12  or  16  bits 
wide  if  all  they  do  is  indicate  whether  a  cluster  is  occupied  or  not.  This  could  have 
been  done  with  one  bit:  The  bit  could  contain  1  when  the  cluster  is  occupied  and  0 
if  the  cluster  is  available.  The  reason  is  that  the  entries  in  the  FAT  help  mark  the 
available  clusters  and  identify  the  individual  clusters  containing  a  specific  file.  The 
directory  entry  of  a  file  tells  DOS  which  cluster  holds  the  first  data  of  a  file.  The 
number  of  this  cluster  corresponds  to  the  number  of  the  FAT  entry  belonging  to 
it.  In  this  entry  is  the  number  of  the  cluster  containing  the  next  sector  of  file  data. 
As  the  following  illustration  shows,  a  chain  forms  in  which  the  individual  clusters 
assigned  to  a  file  can  be  located  in  the  proper  sequence. 
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Media  descriptor 

entry  number 

0. 

1. 

2. 

3. 

4. 

5. 

6. 

7. 

8. 

9. 

A. 

B. 

C. 

D. 

E. 

F. 


FAT 

(12  Wt) 


C 


17F(h) 

002  (h) 

006(h) 

007  (h) 

008  (h) 

OOD  (h) 

s 

OOE  (h) 

003  (h) 

. 

Directory  entry  for 

FQRMAT.EXE  file 


00 


M 


FAT  entry  and  file  clusters 

The  FAT  entry  which  corresponds  to  the  last  cluster  of  a  file  must  contain  a 
special  code  which  tells  DOS  that  the  file  ends  here.  The  following  table  shows 
the  meanings  of  the  various  FAT  entries. 


Code 

Meaninq 

(0) OOOH 

Cluster  is  available 

(F)FFOH  -  (F)FF6H 

reserved  cluster 

(F)FF7H 

Cluster  damaged,  not  used 

(F)FF8H  -  (F)FFFH 

Last  file  cluster 

(x) xxxH 

Next  file  cluster 

Note:  The  first  hexadecimal  number  in  parentheses  refers  to  a  FAT  whose 

entries  are  16  bits  wide. 

DOS  is  designed  so  that  several  identical  copies  of  the  FAT  on  the  media  may 
kept.  This  offers  the  advantage  that  in  case  of  damage  to  one  FAT,  it  can 
replaced  with  another,  preventing  data  loss. 

The  DOS  CHKDSK  command  tests  the  various  FATs  to  see  if  they  are  identical. 
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Directory  structure 

Now  let’s  look  at  the  structure  of  a  directory. 

The  root  directory  of  a  volume  immediately  follows  the  last  copy  of  the  FAT. 
This  root  directory  (like  all  subdirectories)  consists  of  32-byte  entries  in  which 
information  can  be  stored  about  individual  files,  subdirectories  and  volume  names. 
The  maximum  number  of  entries  in  the  root  directory,  and  therefore  its  size,  is 
stored  in  the  BPB  starting  at  address  1 IH.  The  FORMAT  command  specifies  both 
the  size  number  and  the  BPB.  Before  considering  individual  fields  of  this  data 
structure,  here’s  a  graphic  overview  of  a  directory  entry: 


+  OOH 

Filename  (blanks  padded  w/  spaces)  (8  bvtes) 

+  08H 

File  extension  (blanks  padded  w/  spaces) (3  bytes) 

+  OBH 

File  attribute  (1  bvte) 

+  OCH 

Reserved  (10  bvtes) 

+  16H 

Time  of  last  chancre  (1  word) 

+  18H 

Date  of  last  chance  (1  word) 

+  lAH 

First  cluster  of  file  (1  word) 

+  ICH 

File  size  (2  words) 

Directory  entry  layout 

The  first  8  bytes  normally  contain  the  name  of  the  current  file.  If  the  filename  is 
shorter  than  8  characters,  DOS  fills  the  remaining  characters  with  spaces  (ASCII 
code  32).  If  the  directory  entry  does  not  contain  information  on  a  file,  but  the  file 
is  used  in  another  manner,  the  first  byte  of  the  filename  (therefore  the  first  byte  of 
the  directory  entry)  is  identified  by  special  code: 


Code 

Meaning 

OOH 

Last  directory  entry 

OSH 

First  character  of  filename 
has  ASCII  code  E5H 

2EH 

File  applies  to  current 
directory 

E5H 

File  deleted 

The  second  field  contains  the  three  character  filename  extension.  If  the  extension  is 
less  than  three  characters  in  length,  DOS  fills  in  the  extra  characters  with  blank 
spaces  (ASCII  code  32).  The  period  between  filename  and  extension  is  displayed  by 
the  DOS  command  DIR  but  is  not  kept  in  the  directory;  DIR  displays  it  just  to 
make  the  names  between  easier  to  read. 

Next  follows  the  one-byte  attribute  field.  As  shown  in  the  following  figure  the 
individual  bits  of  this  field  define  certain  attributes.  The  various  attributes  can  be 
combined  so  that  a  file  (as  in  the  IBMBIOS.COM  file)  can  have  the  attributes 
READ-ONLY,  SYSTEM  and  HIDDEN. 
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1  0  bit 


1=  write-protected 
b=read/write  enabled 


|l=hidden  file 
(invisible  to  DIR) 


jlssystem  file 


ftsvoiume  name 


ftssubdirectory 


archive  bit 


reserved 


Attribute  field  in  the  directory 

While  the  significance  of  bits  0  to  4  is  easy  to  see,  the  significance  of  bit  5  needs 
additional  explanation.  The  name  archive  bit  comes  from  its  use  in  making  backup 
copies.  Every  time  a  file  is  created  or  modified,  this  bit  is  set  to  1.  If  a  program  is 
used  to  backup  this  file,  (for  example  the  DOS  BACKUP  command),  the  archive 
bit  is  reset  to  0.  The  next  time  the  BACKUP  command  is  used,  it  can  determine 
from  the  archive  bit  whether  this  file  has  been  modified  since  the  last  backup.  If  it 
still  contains  the  value  0,  the  file  doesn’t  have  to  be  backed  up  again.  If  the  archive 
bit  contains  a  1,  the  file  was  modified  and  should  be  backed  up  again. 

The  attributes  volume  name  and  subdirectory  will  be  discussed  in  more  detail 
below. 

A  reserved  field  which  DOS  requires  for  internal  operations  follows  the  attribute 
field. 

The  time  and  date  fields  indicate  when  the  file  was  last  created  or  modified.  Both 
are  stored  as  words  (2  bytes),  but  have  special  and  different  formats. 
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15  14  13  12  11  10  9  8  7  6  54  32  1  0  bit 


Hour  Minute  Seconds  in 


2-second 
increments  (e.g.,)t 
(13  means  26) 

15  14  13  12  11  10  9  8  7654  32  1  0  bit 


Year  (reiative  to  1980)  Month  Day  of  month 


Time! date  field formats  in  directory  entry 

The  next  field  indicates  the  number  of  the  cluster  which  contains  the  first  data  of 
the  file.  It  also  indicates  the  numba*  of  the  FAT  containing  the  numb»  of  the  next 
cluster  assigned  to  the  file.  This  field  forms  the  beginning  of  a  chain  through 
which  all  the  clusters  assigned  to  a  file  can  be  retrieved. 

The  file  size  in  bytes  is  stored  in  2  words  with  the  lower  word  stored  first.  Using  a 
small  formula  and  the  two  words,  the  file  size  can  be  calculated  as  follows: 

File  size  =  wordl  +  word2  *  65,536 

Subdirectory  and  volume  name 

Both  subdirectory  and  volume  name  deserve  special  consideration.  The  volume 
name  can  only  exist  in  the  root  directory  and  is  indicated  by  bit  3  of  the  current 
directory  entry’s  attribute  field.  The  filename  in  a  volume  entry  acts  as  the  volume 
name;  the  DOS  commands  DIR,  VOL  and  TREE  can  be  used  to  display  the 
volume  name. 

If  bit  4  of  the  current  directory’s  attribute  field  is  set,  then  this  entry  is  for  a 
subdirectory.  If  in  addition  bit  1  in  this  field  is  set,  the  subdirectory  can  be 
addressed,  but  will  not  be  displayed  when  you  execute  the  DIR  command.  For 
these  entries,  the  filename  and  extension  field  contain  the  subdirectory  name;  the 
date  and  time  field  contain  the  time  of  its  creation.  The  file  length  field  is  always 
0.  The  field  which  normally  indicates  the  first  cluster  of  the  file  now  indicates  the 
cluster  which  contains  the  directory  entries  of  this  subdirectory.  They  have  the 
same  32-byte  structure  as  the  entries  in  the  root  directory.  As  in  a  normal  file,  the 
entry  in  the  FAT,  which  corresponds  with  the  subdirectory  cluster,  points  to  the 
next  cluster  of  the  subdirectory,  as  long  as  one  cluster  is  enough  for  the  directory 
of  the  subdirectory.  This  is  not  true  of  the  root  directory  which  extends  through 
several  sectors  or  clusters,  which  follow  each  other  logically.  Furthermore  the 
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individual  clusters  of  the  root  directory  cannot  be  connected  through  the  FAT, 
because  it  only  refers  to  the  data  area  of  the  volume.  This  is  the  area  which  accepts 
files  and  subdirectories,  but  not  the  root  directory. 

The  process  described  above  reveals  that  DOS  separates  the  individual  files  in  a 
storage  unit  according  to  their  directories.  It  doesn’t  store  the  files  of  one  directory 
in  one  area,  but  scatters  the  files  across  the  storage  medium. 

When  a  subdirectory  is  created,  two  files  are  created  with  the  names  and 
which  can  only  be  erased  when  you  remove  the  entire  subdirectory.  The  first  of 
these  two  files  points  to  the  current  subdirectory,  and  its  cluster  field  contains  the 
number  of  the  first  cluster  of  the  current  subdirectory.  The  second  entry  points  to 
the  parent  directory,  which  in  the  directory  tree  is  located  ahead  of  the  current 
directory.  If  the  parent  directory  is  the  root  directory,  the  cluster  field  contains  the 
value  0.  The  path  to  the  root  directory  can  be  traced  back  through  this  entry,  since 
as  every  subdirectory  searches  for  its  parent  directory  it  comes  closer  to  the  root 
directory. 

Now  back  to  our  discussion  of  mass  storage  device  structures.  The  file  area  follows 
the  root  directory  just  described.  It  occupies  the  remaining  storage  area  of  the  mass 
storage  device.  It  accepts  the  individual  files  and  various  subdirectories.  For  every 
cluster  in  this  area  there  is  an  entry  in  the  FAT  corresponding  to  this  cluster.  If  a 
file  is  enlarged,  DOS  reserves  a  cluster  which  is  still  available  to  store  the 
additional  data  of  the  file.  The  FAT  entry  of  the  last  cluster  which  formerly 
indicated  the  end  of  file  is  changed  to  point  to  the  new  cluster  which  in  turn 
contains  the  new  end  character.  In  DOS  Versions  1.0  and  2.0,  unused  clusters  are 
searched  for  from  the  beginning.  In  DOS  Versions  3.0  and  up,  a  more 
sophisticated  search  is  used  to  try  to  select  an  unused  cluster  in  the  vicinity  of 
other  clusters  comprising  the  file.  This  reduces  the  access  time  to  the  file  as  much 
as  possible.  Conversely,  when  reducing  file  size  or  deleting  a  file,  the  FAT  is 
updated  to  indicate  that  the  unused  clusters  are  again  available.  They  can  be  used 
again  when  a  new  file  is  created  or  expanded. 
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6.14  Tips  on  Compatibility  between  Computers 

This  book  discusses  three  methods  of  accessing  PC  hardware.  On  the  one  hand, 
you  can  access  available  DOS  or  BIOS  functions.  On  the  other  hand,  you  have  the 
option  of  developing  new  functions  and  routines  for  direct  hardware  control.  While 
this  offers  no  advantage  in  mass  storage  device  and  keyboard  access,  special 
routines  for  screen  display  are  often  much  faster  and  more  efficient  than  BIOS  and 
DOS  routines  used  to  do  the  same  job. 

For  compatibility,  however,  DOS  functions  win  hands  down.  Those  of  you  who 
want  to  develq)  programs  which  can  run,  without  problems,  on  virtually  any  DOS 
computer,  must  observe  some  rules  for  DOS  function  calls.  These  rules  also  apply 
to  future  compatibility.  To  develop  programs  under  the  current  DOS  versions 
which  should  execute  without  problems  under  future  versions  of  DOS,  you  should 
follow  the  suggestions  made  below. 

•  Use  only  DOS  functions  for  screen  and  hardware  access.  Do  not  use  BIOS 
or  other  hardware  dependent  functions. 

•  Display  error  messages  on  the  standard  error  device  (handle  2). 

•  Use  Version  2  UNIX-compatible  handle  functions  for  file  access.  This 
ensures  compatibility  with  future  versions  of  DOS. 

•  If  you  use  the  old  FCB  functions  for  file  or  directory  access  (e.g.,  for 
special  attributes),  make  sure  no  FCBs  are  opened  which  are  already  open, 
and  no  FCBs  are  closed  which  are  already  closed.  This  could  cause 
problems  in  a  netwa-k. 

•  Check  the  DOS  version  number  at  the  beginning  of  the  program  and  end 
the  program  with  an  error  message  if  it  cannot  be  executed  under  this 
version. 

•  Store  as  many  constants  as  needed  for  program  execution  (e.g.,  the  paths 
of  programs  and  files  to  be  loaded)  within  the  environment  block.  Access 
these  values  from  the  environment  block  within  the  program. 

•  Release  all  memory  not  required  by  the  program  using  the  DOS  functions 
(this  is  especially  important  when  working  with  COM  programs). 

•  If  you  need  additional  memory,  request  it  by  using  the  proper  DOS 
functions. 

•  Use  the  available  DOS  functions  for  interrupt  vectors;  do  not  access 
interrupt  vectors  directly. 

•  To  change  the  contents  of  various  interrupt  vectors  within  a  program, 
first  save  the  old  contents  and  restore  them  before  the  end  of  the  program. 
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•  Call  one  of  the  DOS  functions  (31H  or  4CH)  before  the  end  of  the 
program  to  pass  a  value  to  the  calling  program  to  signal  whether  the 
program  was  executed  correctly.  Avoid  using  the  other  functions  for 
ending  a  program  (interrupt  20H  and  function  0  of  interrupt  21H). 

•  Use  function  59H  of  interrupt  21H  (available  in  DOS  Versions  3.0  and 
higher)  to  localize  error  sources. 

In  conclusion,  here  is  an  overview  of  the  older  DOS  functions  to  avoid,  and  the 
new  equivalent  functions  that  can  replace  them. 


loid 

New  1 

OOH 

End  program 

4CH 

End  Process 

OFH 

Open  file 

3DH 

Open  Handle 

lOH 

Close  file 

3EH 

Close  handle 

IIH 

Find  first  entry 

4EH 

Find  first  entry 

12H 

Find  next  entry 

4FH 

Find  next  entry 

13H 

Erase  file 

ma 

14H 

Sequential  read 

3FH 

Read  (through  handle) 

15H 

Sequential  write 

40H 

Write  (through  handle) 

16H 

Created  file 

3CH 

Created  handle 

or 

5AH 

Created  temporary  file 

or 

5BH 

Created  new  file 

17H 

Rename  file 

^9 

21H 

Random  access  read 

3FH 

Read  (through  handle) 

22H 

Random  access  write 

40H 

Write  (through  handle) 

23H 

Sense  file  size 

42H 

Move  file  pointer 

24H 

Set  data  set  number 

42H 

Move  file  pointer 

26H 

Create  new  PSP 

4BH 

Load  and  execute  from 

file 

27H 

Random  access  read 

3FH 

Read  (through  handle) 

28H 

Random  access  write 

40H 

Write  (through  handle) 

If  you  follow  all  these  suggestions,  your  programs  will  execute  on  other 
computers  and  under  future  DOS  versions  with  little  or  no  modifications. 
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6.1 5  Undocumented  DOS  Structures 

DOS  manages  the  operating  storage  media  (RAM  and  mass  storage)  and  programs 
which  use  multiple  data  structures.  Some  of  these  structures  are  thoroughly 
documented  and  have  already  been  described  in  this  book.  These  documented 
structures  include: 

•  Program  Segment  Prefix  (PSP),  which  precedes  every  program  in 
memory 

•  File  Control  Blocks  (FCBs),  which  control  file  access 

•  Memory  Control  Blocks  (MCBs),  which  control  RAM 

•  Structures  in  the  header  of  a  device  driver 

•  Environment  blocks,  which  contain  information  strings  about  every 
program  in  memory 

•  The  many  structures  which  DOS  keeps  in  mass  storage  (boot  sector.  File 
Allocation  Table  [FAT],  root  directory,  etc.) 

In  addition,  there  are  a  number  of  undocumented  structures.  Until  quite  recently, 
only  a  few  people  knew  of  the  existence  of  these  structures,  since  most  technical 
manuals  concerning  DOS  didn't  describe  them.  The  authors  of  many  of  these 
technical  manuals  felt  that  these  structures  weren't  needed  for  programming,  and 
that  their  coding  would  change  in  future  versions  of  DOS.  The  fact  is  that  certain 
kinds  of  programming  do  depend  upon  these  structures,  and  that  some  applications 
couldn't  be  realized  at  all  without  them. 

Floppy  disk  and  hard  disk  management  utilities  make  intensive  use  of  the 
undocumented  structures.  If  you  examine  the  Norton  Utilities®  using  a  debugging 
application,  you'd  see  how  much  this  program  accesses  these  structures. 

A  minor  change  in  these  structures  took  place  between  DOS  Version  3.3  and 
Version  4.0,  but  this  is  the  first  change  since  the  introduction  of  DOS  Version  2.0 
in  1983.  Therefore,  the  chances  are  almost  nil  of  finding  altered  coding  in  the 
undocumented  structures  of  subsequent  DOS  versions. 

Knowing  about  these  structures  can  be  practical  data  for  programming  some 
applications.  This  section  lists  our  findings  from  viewing  the  Norton  Utilities®. 

The  DOS  Info  Block  (DIB)  is  the  key  to  accessing  the  most  important  DOS 
•  structures.  This  block  holds  pointers  to  several  DOS  structures  and  to  other 
information  as  well.  The  knowledge  of  its  existence  and  construction  is  useful  to  a 
program  only  if  its  address  in  memory  is  known.  This  address  is  not  in  a  fixed 
memory  location,  nor  can  it  be  obtained  with  any  of  the  documented  functions  of 
DOS  interrupt  21H.  However,  the  undocumented  function  52H  can  offer  us  some 
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assistance  in  finding  that  address.  Calling  function  S2H  returns  the  address  of  the 
DOS  Info  Block  to  the  ES:BX  register  pair. 

As  opposed  to  all  other  DOS  functions  that  fetch  pointers  to  a  structure  or  data 
area,  the  contents  of  the  ES:BX  register  pair  point  not  to  the  first,  but  rather  to  the 
second  field  within  the  DIB  after  the  function  call. 


|dOS  Info  Block  (DIB)  structure  I 

Addr . 

Contents 

Type _ 1 

“04H 

Pointer  to  MCB 

mam 

ESiBX 

Pointer  to  first  Drive  Parameter  Block  (DPB) 

1  Ptr _ 1 

+04H 

Pointer  to  last  DOS  buffer 

BSBHi 

+08H 

Pointer  to  clock  driver  ($CLOCK) 

1  ptr 

+0CH 

Pointer  to  console  driver  (CON) 

1  ptr 

+10H 

Maximum  sector  length  (based  on  all  connected 
mass  storage  devices) 

1  word 

+12H 

Pointer  to  first  DOS  buffer 

DSSIH 

+16H 

Pointer  to  path  table 

1  ptr 

+1AH 

Pointer  to  System  File  Table  (SFT) 

1  ptr 

The  first  field  in  the  DIB  contains  a  pointer  to  the  Memory  Control  Block  (MCB) 
of  the  first  allocated  memory  area.  You  will  find  detailed  information  on  this 
structure  and  what  it  does  in  Section  6.9  (Memory  Allocation  from  DOS).  The 
pointer  in  the  second  field  of  the  DIB  gives  access  to  a  wealth  of  information  that 
could  not  be  had  in  any  other  way.  It  points  to  the  first  Drive  Parameter  Block 
(DPB),  a  structure  which  DOS  lays  out  for  all  mass  storage  devices  (floppy  disks, 
hard  disks,  tape  drives,  etc.). 


1  Drive  Parameter  Block  (DPB)  structure  | 

Addr . 

Contents 

Type 

+00H 

Number  or  symbol  for  corresponding  drive 
(0  =  A,  1  =  B,  etc.) 

1  byte 

+01H 

Sub-unit  of  device  driver  for  drive 

1  byte 

+02H 

Bytes  per  sector 

1  word 

+04H 

Interleave  factor 

1  byte 

+05H 

Sectors  per  cluster 

+  06H 

Reserved  sectors  (for  boot  sector) 

1  word 

+  08H 

Number  of  File  Allocation  Tables  (FATs) 

1  byte 

+  09H 

Number  of  entries  in  root  directory 

1  word 

+  0BH 

First  occupied  sector 

1  word 

+0DH 

Last  occupied  cluster 

1  word 

+0FH 

Sectors  per  FAT 

1  byte 

+10H 

First  data  sector 

1  word 

+12H 

Pointer  to  header  (correspond,  device  driver) 

1  ptr 

+16H 

Media  descriptor 

+17H 

Used  flag  (0FFH=device  not  yet  in  use) 

+18H 

Pointer  to  next  DPB  (xxxx:FFFF  =  last  DPB) 

1  ptr. _ 1 

1  Length:  ICH  (28)  bytes  I 
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The  first  field  of  the  DPB  tells  us  to  which  device  the  block  belongs.  0  stands  for 
drive  A,  1  for  B,  2  for  C,  etc.  The  second  field  specifies  the  number  of  the  subunit 
To  understand  the  meaning  of  this  field,  remember  that  access  to  the  individual 
devices  occurs  through  the  device  driver.  DOS  doesn't  perform  direct  access  to  a 
disk  drive  or  hard  disk.  This  keeps  DOS  from  having  to  deal  with  the  physical 
characteristics  of  a  mass  storage  device.  Instead,  DOS  calls  a  device  driver  for  this 
purpose,  which  acts  as  mediator  between  DOS  and  hardware. 

Of  course,  not  every  device  has  a  separate  device  driver,  since  one  device  driver  can 
support  many  single  devices.  For  example,  the  device  driver  built  into  DOS 
manages  the  floppy  disk  drives  and  the  first  available  hard  disk.  DOS  configures  a 
DPB  for  each  device,  so  a  hard  disk  system  would  automatically  have  3  DPBs 
available  (a  DPB  is  always  configured  for  floppy  drive  B,  even  if  only  one  floppy 
drive  is  actually  available).  Each  device  receives  a  number  between  0  and  the  total 
number  of  devices  minus  1,  to  help  each  driver  to  identify  the  devices  it  manages. 
This  number  is  the  one  found  in  subunit  field. 

The  next  field  lists  the  number  of  bytes  per  sector.  Under  DOS  this  is  almost 
always  512.  After  this  comes  the  interleave  factor,  which  gives  the  number  of 
logical  sectors  displaced  by  physical  sectors  when  the  medium  is  formatted  (more 
on  this  in  Chapter  7).  This  vdue  can  be  1  for  floppy  disk  drives,  6  for  the  XT  hard 
disk  and  3  for  the  AT  hard  disk.  For  floppy  disk  (hives,  this  field  can  also  have  the 
value  FEH  if  no  access  has  been  attempt^  to  the  disk  in  the  drive.  The  value  FEH 
means  that  the  inteleave  factor  is  currently  unknown. 

There  are  a  number  of  other  fields  related  to  these  two  which  have  already  been 
named  in  connection  with  the  management  of  mass  storage  devices  through  DOS 
(see  Section  6.13).  Among  other  things,  they  describe  the  status  and  the  size  of  the 
structures  DOS  created  to  manage  mass  storage  devices.  A  pointer  to  the  header  of 
the  device  driver  lies  within  these  fields.  DOS  uses  this  pointer  when  accessing  the 
device.  More  information  can  be  obtained  with  this  pointer  since,  for  example,  the 
driver  attribute  is  listed  in  the  header  of  the  device  driver. 

Following  this  field  is  the  media  descriptor  to  which  the  Used  flag  is  connected. 
As  long  as  no  access  to  the  device  has  cxxurred,  this  flag  contains  the  value  OFFH. 
After  the  first  access  it  changes  to  0  and  remains  unchanged  until  a  system  reset. 

The  DPB  ends  with  a  pointer  that  establishes  communication  with  the  next  DPB. 
Since  every  DPB  defines  its  end  with  such  a  pointer,  a  kind  of  chain  is  created, 
through  which  all  DPBs  can  be  reached.  To  signal  the  end  of  the  chain,  the  offset 
address  of  this  pointer  in  the  last  DPB  contains  the  value  OFFFFH.  When  a 
program  needs  the  information  within  the  DOS,  there  are  many  ways  to  find  the 
address  of  the  desired  DPB.  One  method  is  to  follow  the  chain  described  above  by 
first  finding  out  the  address  of  the  DIB.  This  gives  you  the  pointer  to  the  first 
DPB,  from  which  you  can  follow  the  chain  until  you  reach  the  DPB  you  want. 
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There's  a  better  way,  which  isn't  as  susceptible  to  changes  within  the  DIB,  through 
two  undocumented  DOS  functions.  This  involves  the  IFH  and  32H  functions, 
which  have  been  part  of  the  DOS  function  repertoire  since  Version  2.0,  although 
not  documented  by  Microsoft.  When  called,  both  return  a  pointer  to  a  DPB  to  the 
DS:BX  register  pair.  While  function  IFH  always  delivers  a  pointer  to  the  DPB  of 
the  current  disk  drive,  the  address  delivered  by  function  32H  refers  to  the  device 
whose  number  is  passed  to  the  function  in  the  DL  register  at  the  time  it's  called.  (0 
represents  the  current  drive,  1  is  drive  A,  2  drive  B  etc.).  It's  much  more  flexible 
than  function  IFH. 

Access  to  the  various  DPBs  with  the  IFH  and  32H  functions  offers  a  further 
advantage,  because  it  forces  DOS  to  retrieve  other  information  such  as  the 
interleave  factor  and  the  media  descriptor  byte,  which  is  ascertained  for  the  disk 
drive  only  after  the  first  access.  If  you  get  to  the  DPB  through  the  pointer  in  the 
DIB  block,  the  various  fields  may  not  have  been  initialized,  and  could  contain  the 
wrong  values. 

Besides  the  pointer  to  the  first  DPB,  the  DIB  contains  the  pointer  to  the  first  DOS 
buffer  at  address  12H.  These  DOS  buffers  store  individual  sectors,  so  that  the 
sectors  don't  have  to  be  repeatedly  loaded  from  disk.  The  DOS  buffers  can  be  most 
effective  when  used  for  storing  disk  sectors  that  are  frequently  needed  by  the 
currently  running  program.  Besides  the  FAT,  these  include  the  root  directory  and 
its  subdirectories.  The  number  of  buffers  can  be  defined  by  the  user  in  the 
CONFIG.SYS  file.  If  this  number  exceeds  those  needed  for  the  FAT,  root  directory 
and  subdirectories,  normal  sectors  can  also  be  temporarily  stored  here,  in  the  hope 
that  they  are  called  to  be  loaded  again  in  the  near  future,  and  can  be  taken  directly 
from  the  buffer. 

So  that  DOS  can  quickly  check  each  buffer  for  the  desired  sector  with  every  read 
operation,  the  individual  sectors  are  linked  together. 


|dOS  buffer  structure  I 

Addr . 

Contents 

Type 

+00H 

Pointer  to  next  DOS  buffer 

1  ptr 

+04H 

Drive  number  (0  =  A,  1  =  B  etc.) 

1  byte 

+  05H 

Flags 

1  byte 

+06H 

Sector  number 

1  word 

+08H 

Reserved 

2  bytes 

+0AH 

Contents  of  buffered  sector 

512  bytes 

[Length:  210H  (528)  bytes  I 

As  with  DPBs,  this  happens  with  the  help  of  a  pointer  which  appears  at  the  start 
of  every  buffer.  Also,  the  last  buffer  is  reached  when  the  offset  address  of  the 
pointer  contains  the  value  OFFFFH.  After  the  field  linking  one  buffer  to  the  next 
comes  the  number  of  the  drive  where  the  buffered  sector  originates.  The  value 
would  be  0  for  drive  A,  1  for  B,  2  for  C,  etc.  Besides  the  drive  number,  the 
identification  of  a  sector  requires  a  sector  number.  This  is  located  beginning  at 
position  06H  in  the  DOS  buffer.  The  last  field  in  the  buffer  header  stores  a  pointer 
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to  the  corresponding  DPB,  so  that  DOS  can  get  information  on  the  device  which 
loaded  the  buffered  sector.  Although  this  is  the  last  field  in  the  header  of  the  DOS 
buffer,  the  buffo^  sector  does  not  end  immediately  after  this  field.  There  are  two 
more  bytes  which  follow.  The  reason  for  this  is  that  the  DOS  code  is  written  in 
machine  language,  and  when  it  comes  to  working  with  memory  blocks,  it  is  most 
efficient  to  have  the  buffered  sectw  begin  with  an  address  that  is  divisible  by  16. 

The  header  of  the  DOS  buffer  is  not  the  last  place  we  run  across  the  DPB.  It  turns 
up  again  in  the  path  table,  which  starts  at  address  16H  in  the  DIB.  This  contains 
the  current  path  for  each  drive  as  well  as  a  pointer  to  its  DPB. 
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Memory  dump  of  the  path  table  contents 

As  long  as  the  LASTDRIVE  command  is  in  the  system’s  configuration  file,  the 
table  will  have  entries  for  drives  A  through  the  one  specified  by  LASTDRIVE.  If 
this  command  is  missing,  however,  the  table  will  only  have  entries  for  each  device 
supported  by  the  installed  device  driver.  If  you  change  the  entries  in  this  table,  you 
can  divert  one  drive  to  another.  The  JOIN  and  SUBST  DOS  commands  also  take 
advantage  of  this  by  manipulating  the  path  table  entry  of  the  drive  to  be  diverted. 
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6.16  DOS  4.0 

People  were  rather  surprised  when  IBM  introduced  DOS  4.0  instead  of  DOS  3.4. 
The  version  number  suggests  vast  improvements  to  this  operating  system. 
Version  4.0  does  in  fact  have  some  features  to  offer  which  clearly  set  it  apart  from 
its  predecessors: 

•  Full-screen  system  installation 

•  Graphic  user  interfaces  for  directory  display,  file  selection  and  running 

programs 

•  Full  mouse  support 

•  Support  of  Extended  Memory  Specification  (EMS)  according  to  the  LIM 

4.0  specification  for  buffer  storage 

•  Hard  disk  partition  (volume)  support  and  support  for  device  capacity  larger 
than  32  megabytes 

•  Improved  file  access  through  optimization  of  the  system  code 

The  introduction  of  these  features  mean  changes  in  the  operating  system  code. 
Although  most  of  these  changes  will  not  affect  most  application  programs,  they 
may  cause  problems  in  programs  that  lie  within  the  system,  as  well  as  programs 
developed  without  following  rules  of  compatibility  (see  Section  6.14). 

Compatibility  problems 

First  of  all,  the  support  of  hard  disk  partitions  and  files  larger  than  32  megabytes 
implies  definite  changes  to  the  DOS  file  system.  These  changes  don’t  affect 
programs  that  manipulate  files  only  through  the  DOS  interrupt  21H  functions. 
However,  many  block  device  drivers  and  programs  that  access  the  DOS  structures 
of  the  file  system  directly  will  have  to  be  adapted  to  the  new  file  system.  This 
includes  programs  like  the  Norton  Utilities®,  PC  Tools®  and  all  the  other 
utilities  which  perform  tasks  such  as  optimizing  hard  disks  and  restoring  lost  files. 
All  of  these  will  be  of  little  or  no  use  under  DOS  Version  4.0. 

To  give  you  a  chance  to  adapt  programs  affected  by  these  changes  to  DOS  4.0,  the 
following  pages  give  a  description  of  changes  to  the  file  system  (see  Section  6.13 
for  a  comprehensive  look  at  the  DOS  file  system). 

In  order  to  best  visualize  the  changes  to  the  file  system,  let's  begin  with  a  picture 
of  its  fundamental  structure,  which  remains  valid  under  Version  4.0.  This 
fundamental  structure  can  be  divided  into  three  layers,  one  on  top  of  the  other. 
These  range  from  the  logical  partitioning  of  a  mass  storage  device  on  the  top  layer 
to  a  purely  physical  system  on  the  bottom  layer.  The  top  layer  forms  the  function 
interface  to  user  programs.  This  interface  calls  individual  functions  through 
interrupt  21H.  No  changes  are  allowed  on  this  level  in  the  switch  to  DOS  4.0  to 
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ensure  that  all  applications  that  use  these  functions  will  continue  to  run  normally. 
File  accesses  from  the  first  level  are  converted  to  device  driver  function  calls  on  the 
second  level.  In  order  to  locate  each  file  (i.e.,  retrieve  the  sectors  which  must  be 
accessed)  this  level  uses  various  data  structures  which  are  kept  in  the  storage 
medium.  These  include: 

•  The  boot  sector  (including  the  BIOS  parameter  block  [BPB]) 

•  The  root  directCMy  and  its  subdirectories 

•  The  FAT  and  its  duplicates 

These  functions  cannot  be  changed  as  well,  since  one  of  the  most  important 
demands  placed  on  the  new  DOS  version  is  the  ability  to  work  with  partitions  that 
were  created  and  formatted  under  previous  versions.  This  is  possible  only  if  the 
structures  listed  above  are  not  changed.  This  does  not  leave  many  ways  to  increase 
the  cs^acity  of  a  volume.  Since  the  size  of  the  FAT  entry  is  limited  to  16  bits,  a 
volume  can  use  no  more  than  65519  clusters.  Therefore,  an  increase  is  possible 
only  by  using  more  sectors  in  a  cluster. 


When  DOS  4.0  sets  up  new  partitions,  it  assigns  the  following  cluster  sizes: 


1  Partition  and  cluster  sizes  under  DOS  4.0  I 

256  meg 

512  meg 

1028  meg 

2048  meg 

Iciuster  size 

2  K 

4  K 

8  K 

16  K 

32  K 

4 

8 

16 

32 

64 

While  this  procedure  minimizes  the  changes  on  the  second  level  of  the  file  system, 
it  also  has  a  disadvantage:  The  bigger  the  partition,  the  more  memory  it  wastes. 
Since  the  memory  in  a  partition  can  only  be  allocated  in  clusters,  some  memory  is 
always  wasted  when  a  cluster  is  not  completely  filled.  This  is  true  of  files  that  are 
smaller  than  the  cluster  size.  Memory  space  is  also  wasted  in  the  last  cluster  of  a 
larger  file,  since  the  size  of  a  file  is  rarely  an  integral  multiple  of  the  cluster  size. 

Device  driver  level 

The  changes  become  most  noticeable  on  the  third  level  of  the  file  system,  called 
the  device  driver  level.  While  character  drivers  remain  unaffected  by  changes  in  the 
partition  size,  these  changes  have  a  great  impact  on  block  drivers  that  support 
partitions  of  more  than  32  megabytes. 

It's  true  that  changes  on  this  level  could  be  kept  to  a  minimum  by  increasing  the 
sector  size  from  512  bytes,  but  this  could  lead  to  compatibility  problems  with 
partitions  that  were  configured  under  previous  versions  of  DOS.  The  only 
alternative  was  to  increase  the  number  of  sectors  per  partition.  But  when  a 
partition  exceeds  the  32-megabyte  limit,  the  16  bits,  which  up  until  now  were 
used  to  store  the  logical  sector  number,  are  no  longer  enough.  For  this  reason, 
DOS  4.0  has  introduced  a  new  type  of  block  driver  that  supports  partitions  larger 
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than  32  megabytes,  and  works  with  32-bit  sector  numbers.  DOS  recognizes  these 
drivers  with  the  help  of  bit  1  in  the  device  attribute.  This  bit  carried  a  value  of  0  in 
previous  versions  of  DOS. 

Starting  with  Version  4.0,  DOS  knows  that  it  is  dealing  with  a  32  bit  driver  if 
this  bit  is  turned  on.  Increasing  the  sector  number  also  changed  the  structure  of  the 
parameter  data  block,  with  which  DOS  passes  information  on  the  functions  and 
parameters  being  called,  to  the  device  driver.  Since  a  16-bit  field  is  no  longer  large 
enough  for  the  sector  number,  DOS  4.0  adds  a  32-bit  field  to  the  end  of  the  block. 
This  stores  the  sector  number  for  a  32-bit  driver  as  a  dword  (double  word).  As 
usual,  the  word  with  the  smaller  value  is  stored  before  that  with  the  larger  value. 
To  indicate  that  the  new  field  is  in  use,  DOS  also  loads  the  value  -1  (FFFFH)  into 
the  old  field. 


structure  of  the  extended  parameter  data  block  when 
calling  a  function  of  a  32-bit  driver  under  DOS  4.0 

Addr . 

Contents 

+00H 

Length  of  data  block  in  bytes 

1  byte 

+01H 

Number  of  device  being  addressed 

1  byte 

+02H 

Number  of  function  being  called 

1  byte 

+03H 

Status  word 

1  word 

+05H 

Reserved 

+0DH 

Media  descriptor 

1  byte 

+0EH 

Address  of  parameter  buffer 

1  ptr 

+12H 

Number  of  sectors  to  process 

1  word 

+14H 

Number  of  first  sector  for  16  bit  drivers 

1  word 

+  16H 

Number  of  first  sector  for  32  bit  drivers 

1  dword 

1  Length:  lAH  (2  6)  bytes  I 

The  following  driver  functions  are  affected  by  the  change  to  32-bit  sector  numbers: 
0  initialize  driver 

2  setBPB 

3  directread 

4  read 

8  write 

9  write  and  encode 

12  direct  write 

The  structure  of  the  BIOS  parameter  block  (BPB),  which  the  initialize  driver 
function  must  pass  to  DOS,  has  also  changed.  This  structure  is  also  part  of  the 
boot  sector  of  a  DOS  volume.  It  has  been  supplemented  by  two  fields  compared  to 
the  old  BPB,  and  now  looks  like  this: 
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1  Extended  BIOS  parameter  block  (BPB)  structure  under  DOS  4.0  | 

Addr. 

Contents 

Type 

+00H 

Bytes  per  sector 

1  word 

+02H 

Sectors  per  cluster 

1  byte 

+03H 

Number  of  reserved  sectors 

1  word 

+  05H 

Number  of  file  allocation  tables  (FATs) 

1  byte 

+06H 

Number  of  entries  in  root  directory 

1  word 

+08H 

Number  of  sectors  in  volume 
(partitions  <=  32  MB  only) 

1  word 

+0AH 

Media  descriptor 

1  byte 

+0BH 

Number  of  sectors  per  FAT 

1  word 

+0DH 

Sectors  per  spur 

1  word 

+  0FH 

Number  of  read/write  heads 

1  word 

+11H 

Distance  of  volume's  first  sector  from  first 
sector  on  medium  (partitions  <=  32  MBs^  only) 

1  word 

+13H 

Distance  of  first  sector  in  volume  from  first 
sector  on  medium  (partitions  >  32  MB  only) 

1  dword 

+  17H 

Number  of  sectors  in  volume 
(partitions  >  32  MB  only) 

1  dword 

iLength:  IBH  (27)  bytes  I 

The  two  new  fields  in  this  extended  BPB  refer  to  the  total  number  of  sectors  in  the 
volume  and  the  number  of  sectors  between  the  first  sector  on  the  storage  medium 
and  the  first  sector  of  the  volume.  Even  though  these  fields  were  already  present  in 
the  old  BPB,  they  were  there  only  as  16-bit  values,  and  had  to  be  appended  as  32- 
bit  fields.  To  guarantee  maximum  compatibility  with  the  drivers  of  previous  DOS 
versions,  DOS  only  needs  to  use  the  new  BPB  when  the  sector  numbers  cannot  be 
represented  as  16-bit  values.  This  happens  if  the  distance  from  the  first  sector  on 
the  storage  medium  to  the  first  sector  in  the  volume  is  greater  than  32  megabytes. 

The  new  BPB  is  installed  while  formatting  a  volume,  but  the  old  16  bit  fields  are 
used  to  store  the  number  of  sectors  and  the  distance  from  the  first  sector  when  the 
conditions  mentioned  above  don’t  apply.  Otherwise,  the  corresponding  values  are 
entered  in  the  32  bit  fields  and  the  16  bit  fields  are  assigned  a  value  of  0. 

Extending  the  logical  sector  number  to  32  bits  also  caused  a  change  in  the  way  the 
25H  and  26H  interrupt  functions  work.  These  functions  represent  the  only  way  for 
an  end-user  program  to  directly  access  the  individual  sectors  of  a  volume  via  DOS. 
If  the  number  of  the  first  sector  to  be  processed  was  passed  to  the  DX  register  of 
these  interrupts  by  an  earlier  DOS  version,  direct  sector  access  is  only  possible 
under  Version  4.0  if  the  volume  to  be  accessed  is  smaller  than  32  megabytes.  To 
access  larger  volumes  in  Version  4.0  and  higher,  the  DS:BX  register  pair  of  these 
interrupts  must  receive  a  pointer  to  the  data  block  pictured  on  the  next  page: 
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structure  of  data  block  used  in  calling  interrupts 

25H  and  26H  under  DOS  4.0 

Addr. 

Contents 

Type 

+00H 

Number  of  first  sector 

1  dword 

+04H 

Number  of  sectors 

1  word 

+06H 

Pointer  to  buffer 

1  ptr 

Length 

:  OAH  (10)  bytes 

At  the  same  time  a  value  of  -1  (FFFFH)  must  be  passed  to  the  CX  register,  so 
that  DOS  knows  that  the  parameter  transfer  will  not  be  following  the  old  scheme. 
In  conclusion,  there  is  one  more  little  innovation  to  mention.  While  this  has  no 
impact  on  program  development  under  DOS  4.0,  it  does  show  that  the  80386  has 
truly  come  of  age.  For  example,  80386  PCs  can  use  a  particular  trick  to  speed  up 
file  access  and  corresponding  buffer  and  cache  operations.  DOS  uses  the 
capabilities  of  the  80386  very  skillfully  by  running  string  instructions  using 
bytes,  words  and  dwords  (double  words).  When  copying  and  pushing  memory 
blocks  within  the  lO.SYS  and  MSDOS.SYS  modules,  the  following  code 
sequence  is  used  to  process  the  transcription  in  dwords: 


MOV  CX,  NUMBER 
SHR  CX,  1 
DB  66h 
REP  MOVSW 


/load  number  of  words  to  move 
/cut  number  of  words  to  move  in  half 
/dword  prefix  for  string  command 
/copy  memory  block 


Since  neither  the  8088  nor  the  80286  processors  can  perform  dword  operations,  the 
SHR  CX,1  and  the  DB  66H  instructions  are  simply  replaced  with  NOP 
instructions  when  installing  the  module,  if  the  PC  is  equipped  with  a  processor 
other  than  an  80386. 
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BIOS  is  the  abbreviation  for  Basic  Inpul/Output  System.  The  name  indicates  that 
the  BIOS  provides  basic  input  and  output  routines  for  communicating  between 
software  and  the  hardware  peripherals  such  as  keyboard,  screen  and  disk  drive. 

Why  the  BIOS  is  important 

Since  these  routine  calls  are  standardized,  this  saves  the  programmer  the  trouble  of 
fitting  programs  to  one  particular  PC  hardware  configuration.  This  means  you  can 
develop  a  program  on  one  PC  or  compatible,  and  run  it  on  another  compatible  PC 
without  errors,  even  though  neither  the  hardware  nor  the  individual  BIOS  routines 
are  completely  compatible.  This  hardware  independent  concept  contributed  much  to 
the  popularity  of  the  PC.  It  offers  the  computer  manufacturers  the  ability  to 
develop  PCs  which  aren’t  quite  identical  to  a  true  IBM  PC,  yet  can  run  popular 
software. 

About  BIOS  functions 

BIOS  functions  occur  through  the  individual  routines  contained  in  the  BIOS 
interrupts  lOH  to  17H  and  lAH.  The  processor  registers,  whose  usage  is  also 
standardized,  transfer  data  from  the  calling  program  to  the  interrupt  and  from  the 
interrupt  to  the  calling  program. 


Number 

Meaninq 

lOH 

BIOS  display  function  call 

IIH 

Testing  the  configuration 

12H 

Testing  RAM 

13H 

BIOS  disk  functions 

14H 

Functions  for  asynchronous  communication 

15H 

Cassette  functions 

16H 

Reading  the  keyboard 
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BIOS  architecture 

The  BIOS  itself  is  located  in  PC  ROM,  making  it  resident  even  after  the  computer 
has  been  turned  off.  It  is  stored  very  high  in  the  processor's  address  space 
beginning  at  address  F000:E000.  It  extends  to  address  FOOOrFFFF,  the  last 
location  addressable  on  the  Intel  8088  microprocessor.  The  BIOS  routines  must 
create,  store  and  modify  variables,  much  like  any  other  routine.  Since  this  is 
impossible  in  the  BIOS  area  itself,  BIOS  stores  these  variables  in  the  lower  part  of 
memory  starting  at  address  0040:0000. 

This  chtq>ter  begins  with  a  description  of  the  bootstrap,  followed  by  descriptions  of 
each  BIOS  function,  call  and  application. 
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7.1  Booting  the  System 

Section  6.3  described  the  booting  process  of  DOS.  The  examination  began  at  the 
point  where  the  first  sector  of  a  disdcette  or  hard  disk  loads  into  memory.  From  the 
time  you  switch  on  the  computer  to  the  booting  process,  a  series  of  events  occur. 
This  section  describes  those  interim  events. 

Initialization 

Program  execution  in  a  computer  based  on  the  Intel  8088  (or  one  of  its  successors) 
starts  after  the  computer  is  turned  on  at  memory  location  F000:FFF0.  This 
memory  location  is  part  of  the  ROM-BIOS  and  contains  a  jump  command  to  a 
BIOS  routine  which  takes  over  system  initialization.  The  location  of  this  routine 
may  differ  from  one  computer  to  another  (actually  from  BIOS  to  BIOS)  because 
the  BIOS  changes  internally  with  each  manufacturer.  The  task  this  routine 
performs  remains  identical  for  nearly  all  PCs,  however. 

System  check 

First  the  BIOS  tests  individual  functions  of  the  processor,  its  registers  and  some 
instructions.  If  an  error  occurs  during  this  test,  the  system  stops  without 
displaying  an  error  message  (this  is  impossible  with  a  defective  processor).  If  the 
CPU  passes  the  test,  a  checksum  is  computed  from  each  of  the  ROM's  contents 
and  compared  with  the  various  ROMs  to  determine  whether  a  defect  exists  there. 
Each  chip  on  the  main  circuit  board  (such  as  the  8259  interrupt,  the  8237  DMA 
controller,  and  the  RAM  chips)  goes  through  tests  and  initialization. 

Peripheral  testing 

After  determining  the  functionality  of  the  main  circuit  board,  the  computer  tests 
the  peripherals  (keyboard,  disk  drive,  etc.).  In  addition  to  these  hardware  related 
tasks,  the  BIOS  variables  and  the  interrupt  vector  table  must  be  initialized. 

The  bootstrap  loader 

Note  that  no  mention  has  been  made  of  the  operating  system  so  far.  It  hasn’t  been 
loaded  into  the  computer  from  diskette  or  hard  disk  yet.  Interrupt  19H,  known  as 
the  bootstrap  loader,  performs  this  task  on  startup  or  on  system  reset  (when  you 
press  the  <Alt><Ctrl><Delete>  key  combination).  This  routine  tries  to  load  some 
form  of  the  basic  operating  system  from  a  predetermined  place  on  the  diskette. 

Reasons  for  failure 

This  bootstr^  process  may  fail  for  a  number  of  reasons: 

•  There  is  no  disk  in  the  disk  drive. 

•  There  is  a  disk  in  the  drive,  but  the  disk  isn’t  bootable  (the  DOS  files  are 
not  available  on  the  diskette).  If  this  occurs,  the  bootstrap  routine 
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attempts  to  find  the  routine  on  the  other  disk  drives  connected  to  the  PC, 
or  on  a  predetermined  location  on  an  existing  hard  disk. 

If  the  system  still  cannot  find  the  bootable  system  disk,  there  are  two  other  reasons 

that  may  be  causing  a  problem: 

•  Some  older  systems  switch  to  ROM  BASIC.  This  is  a  small  BASIC 
interpreter  stored  in  PC  ROM  directly  beneath  the  BIOS  starting  at 
memory  location  F000:6000.  New  PCs  display  a  message  on  the  screen 
requesting  that  the  user  insert  a  diskette  containing  the  operating  system 
into  the  drive. 

•  BIOS  doesn't  care  what  operating  system  it  loads,  so  it  may  attempt  to 
load  a  non-DOS  operating  system  if  one  exists  on  the  disk.  This  makes  it 
possible  to  load  other  operating  systems  such  as  XENIX. 
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7.2  Determining  BIOS  Version 

The  previous  section  described  memory  location  FOOOrFFFO  in  conjunction  with 
the  system  startup.  Usually  a  S-byte-long  jump  instruction  can  be  found  at  this 
location.  After  this  instruction,  an  additional  11  bytes  are  available  (to 
F000:FFFF),  which  are  normally  used  to  store  the  release  date  of  the  BIOS 
version. 

You  can  examine  the  contents  of  these  memory  locations  to  determine  which 
BIOS  version  your  PC  uses.  Call  the  DEBUG  program  from  the  DOS  prompt: 

debug 

Enter  the  following  line  to  display  the  bytes  at  the  end  of  the  ROM-BIOS: 

d  fOOOifffO  1  10 

The  next  line  displays  the  contents  of  this  memory  location  as  a  hexadecimal 
number;  the  characters  to  the  right  of  the  hex  display  are  the  corresponding  ASCII 
codes.  Day,  month  and  year  ^pear  as  two  digits  separated  by "/”  characters. 

Odebug 

-d  fOOOrfffO  1  10 

FOOOrFFFO  EA  5B  EO  00  FO  30  27  ?F~.-^Q  .-^6  7F  .-^8  36  00  FC  00  f ... 02/06/86. . . 

-q 

C> 


BIOS  date  display  in  DEBUG 
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7.3  Determining  the  PC  Type 

Usage  of  certain  BIOS  functions  are  more  for  model  identification  than  for  BIOS 
version  identification.  They  indicate  the  type  of  PC  in  use.  They  also  indicate 
when  the  BIOS  has  additional  functions  (e.g.,  AT  BIOS  is  better  equipped  than  the 
PC  and  XT  BIOS).  These  extra  functions  essentially  handle  string  output  on  the 
screen,  realtime  clock  access  (standard  on  the  AT)  and  additional  RAM  beyond  the 
1  megabyte  memory  limit  (also  standard  on  the  AT). 

A  program  which  calls  these  functions  must  first  ensure  that  the  computer  in  use 
is  in  fact  an  AT,  and  that  the  functions  addressed  are  available.  The  programmer 
can  use  the  model  identification  byte  located  in  the  last  memory  location  of  the 
ROM-BIOS  at  address  FOOOiFFFE.  This  byte  can  contain  the  following  codes: 

252  or  FCH:  AT 

254  or  FEH:  XT  and  portable  PC 

255  or  FFH:  PC 

Note:  These  values  aren't  entirely  accurate.  Many  PC/XT  compatibles 

indicate  completely  different  values  in  the  model  identification  byte. 
The  following  rule  of  thumb  may  be  used:  A  model  identification 
byte  of  252  identifies  an  AT;  any  other  number  indicates  a  PC/XT. 

Only  IBM  computers  have  guaranteed  reliable  model  identification  numbers  at 
memory  location  F000:FFFE.  This  may  not  be  the  case  for  compatible 
computers.  Use  the  DOS  program  DEBUG  to  obtain  the  model  identification  byte. 
Call  DEBUG  with 

debug 

Enter  the  following  command  sequence: 

d  fOOOifffe  1  1 

The  model  identification  appears  as  a  hexadecimal  number  on  the  screen. 

Access  to  the  model  identification  byte  from  programs 

The  model  identification  can  be  obtained  directly  from  a  program.  Here's  a  short 
assembler  program  to  perform  that  task: 

IDSeg  segment  at  fOOOh 
org  Offfeh 
PcID  db  (?) 

IDSeg  ends 


push  ds 
mov  ax, IDSeg 
mov  ds,ax 


; store  data  segment 
;Set  Data  segment  to  BIOS 
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Clip 

PcID,252 

/test  if  AT-Code 

pop 

ds 

/restore  Data  segment 

je 

I  St  AT 

/Device  is  a  PC/XT 


I St AT  label  near 


Higher  level  languages  can  also  find  the  identification  byte.  The  following  BASIC 
program  uses  the  PEEK  statement  for  reading  the  model  identification. 

10  def  seg  =  &hF000 

20  if  peek(&hFFFE)  «  252  then  print  "AT"  else  print  -PC/XT- 

Turbo  Pascal  uses  the  mem  array  to  read  the  model  identification: 


begin 

if  inem[$F000  :  $FFFE]  =  252  then  writeln ('AT' ) 

else  writeln ('PC/XT' ); 

end; 


How  the  model  identification  is  used  in  a  program  will  be  demonstrated  in  the 
programs  later  in  this  chapter. 
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7.4  BIOS  Screen  Output  Functions 

The  BIOS  contains  a  series  of  routines  which  display  data  on  the  screen  and 
maintain  other  display  functions.  In  addition  to  the  video  mode,  BIOS  manages 
cursor  positioning,  text  output  and  gr^hic  display  routines.  Interrupt  lOH  calls  all 
these  routines.  The  processor  registers  transfer  the  data  between  the  application 
program  and  the  BIOS  interrupt  routine. 

UndCT  DOS  vmions  1.0  and  1.1,  these  BIOS  routines  were  the  only  options  for 
cursor  positioning  and  color  choice.  DOS  Versions  2.0  and  up  make  these 
functions  available  under  DOS  as  well. 

More  about  compatibility 

The  BIOS  routines  execute  faster  than  their  corresponding  DOS  routines.  Those 
concerned  about  compatibility  and  ou^ut  device  redirection  may  be  bette  off  using 
DOS  routines.  In  any  case,  the  application  itself  should  dictate  which  routines  will 
be  used. 

The  BIOS  routines,  like  the  DOS  routines,  offer  the  programmer  the  advantage  of 
independence  from  a  particular  video  card  (IBM  monochrome,  IBM  color,  Hercules, 
etc.),  since  they  can  be  adapted  to  various  cards.  Because  these  cards  have  different 
features  supported  by  BIOS,  let’s  look  at  the  capabilities  of  these  cards  before 
examining  the  routines  of  interrupt  lOH.  Programs  demonstrating  the  function 
calls  are  listed  in  BASIC,  Turbo  Pascal,  C  and  assembly  language  later  in  this 
chapter. 

Monochrome  display  adapter 

This  card  displays  a  page  of  25  lines  and  80  columns.  Column  0  and  line  0  are  in 
the  upper  left  hand  comer  of  the  display.  The  numbering  continues  to  the  right  and 
down  from  column  0,  line  0. 
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ROWS 


Line  and  column  numbering — monochrome  display 

Each  of  the  2000  (80*25)  positions  on  the  screen  is  represented  by  a  character  from 
a  set  of  256  characters  (IBM  PC  standard  character  set)  and  an  attribute  character, 
also  called  an  attribute  byte.  Both  characters  require  one  byte  apiece,  so  2000*2 
(4000  bytes)  of  video  RAM  must  be  available  to  display  the  entire  screen.  This 
video  RAM  exists  on  the  video  display  card.  Since  video  RAM  is  not  part  of  the 
normal  RAM,  the  starting  address  remains  constant  at  address  B000:0000  for  the 
monochrome  card. 

While  the  PC  systems  have  standard  character  sets  for  all  the  video  cards  described 
here,  the  attribute  bytes  change  from  card  to  card. 

As  the  figure  below  shows,  bits  0  to  2  and  4  to  6  of  the  attribute  byte  defines  the 
foreground  and  background  color  of  the  displayed  character. 
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Bit  3  of  the  attribute  byte  indicates  the  intensity  of  the  foreground  color.  If  it 
contains  a  1,  the  character  appears  in  high  intensity.  Bit  8  indicates  whether  the 
character  on  the  screen  should  blink  (a  1  in  this  bit  causes  the  character  to  blink). 
While  these  bits  can  be  set  in  any  manner,  only  bit  combinations  which  "look 
good”  should  be  used  for  foreground  and  background  color. 


bit 


No  characters 
(black  on  black) 


Underlined  characters 


7  6  5  4  3  2  1  0 

Normal  characters 
(white  on  black) 

7  6  5  4  3  2  1  0  bit 

Inverse  characters 
(black  on  white) 

7654  321  0  t)it 

White  character  field 
(white  on  white) 


Colors  and  attribute  byte— monochrome  display  adapter 
Color  graphics  adapter  (CGA) 

This  card  offers  text  display  of  the  IBM  PC  standard  character  set  and  various 
graphic  modes.  Text  mode  works  with  a  resolution  of  either  80x25  or  40x25 
characters.  40x25  resolution  displays  characters  in  double  width.  This  mode  allows 
the  management  of  up  to  eight  different  video  pages  (80x25  mode  allows  up  to 
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four  different  pages).  The  line  and  column  numbo'  assignment  is  similar  to  the 
monochrome  di^lay  card. 

CGA  attribute  bytes 

The  attribute  byte  used  on  this  card  mainly  selects  foreground  and  background 
colors  of  the  characters.  A  total  of  16  colors  is  available.  The  first  eight  of  these 
may  be  used  as  background  colors. 


Dec. 

Color 

0000(b) 

0 

Black 

0001(b) 

1 

Blue 

0010(b) 

2 

Green 

0011(b) 

3 

0100(b) 

4 

Red 

0101(b) 

5 

Maqenta 

0110(b) 

6 

Brown  (dark  yellow  on  some  monitors) 

0111(b) 

7 

1000(b) 

8 

Dark  Gray  (or  black) 

1001 (b) 

9 

Light  Blue 

1010(b) 

10 

Light  Green 

1011(b) 

11 

Light  Turguoise 

1100(b) 

12 

Light  Red 

1101(b) 

13 

Light  Magenta 

1110(b) 

14 

Yellow  (also  light  yellow) 

1111 (b) 

15 

White 

As  the  figure  below  shows,  bits  0  to  3  of  the  attribute  bytes  represent  the 
foreground  color,  while  bits  4  to  6  indicate  the  background  color.  Bit  7  means  the 
same  as  in  the  monochrome  display  card:  it  decides  whether  the  character  should 
blink. 


76543210 

bit 

1  1 

^  V 

1 _ 

Character  color 

Background  color 

Blinking 

0  =  off,1  =  on 

Attribute  byte  structure— color  graphic  adapter 

This  card  can  emulate  a  monochrome  display  card  (see  above)  in  which  the 
attribute  character  has  the  same  meaning  as  in  the  monochrome  card,  with  the 
excq)tion  that  no  underlined  characters  can  be  produced. 
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Graphic  modes  and  the  CGA 

Graphic  modes  can  have  either  a  resolution  of  640x200  dots  with  2  colors  or 
320x200  dots  with  4  colors.  In  both  modes  the  upper  left  comer  of  the  screen  has 
the  coordinates  0/0. 

No  attribute  byte  exists  in  this  mode  since  every  dot  on  the  display  is  either 
illuminated  with  a  color  or  not,  and  not  composed  of  standard  characters  from  a 
character  set.  To  display  characters  from  the  standard  character  set  in  this  mode, 
they  must  be  drawn  on  the  screen  with  pixels  (dots). 

In  320x200  resolution,  one  of  the  16  available  colors  can  be  defined  as  a 
background  color.  The  foreground  color  must  be  one  of  three  colors  in  a  palette 
predetermined  by  the  graphic  card.  Two  palettes  are  normally  available:  One 
contains  the  colors  cyan,  magenta  and  white,  while  the  other  offers  the  colors 
green,  red  and  yellow. 

The  video  RAM  of  this  card  starts  at  location  B8(X):(XXX)  (unlike  the  monochrome 
display  card  which  starts  at  B(XX):(XXX)).  This  ensures  that  the  video  RAMs  of  the 
two  cards  do  not  overlap.  They  can  be  used  in  parallel  with  each  displaying  data  on 
its  own  monitor. 

Hercules  graphic  cards 

The  Hercules  graphic  card  has  the  same  text  mode  as  the  IBM  monochrome  display 
adapter,  and  can  display  two  video  pages  of  text  at  a  time.  A  Hercules  card  also 
offers  a  graphic  mode  in  which  two  video  pages  can  be  displayed  with  a  resolution 
of  720x348  pixels.  Unfortunately,  the  BIOS  cannot  access  either  the  two  video 
pages  or  the  graphic  mode.  BIOS  treats  this  card  like  a  normal  monochrome  card, 
which  can  only  display  one  text  page  of  80x25  characters. 


Now  that  you  have  some  general  knowledge  of  graphic  adapters,  here  are  the 
functions  called  from  interrupt  lOH: 


Decimal 

Hex 

Meaning 

0 

OH 

Determine  Video  mode 

1 

IH 

Define  cursor  size 

2 

2H 

Determine  cursor  position 

3 

3H 

Sense  cursor  position 

4 

4H 

Read  light  pen 

5 

5H 

Define  current  display  page 

6 

6H 

Scroll  display  up 

7 

7H 

Scroll  display  down 

8 

8H 

Read  character  /  attribute  at  cursor  position 

9 

9H 

Write  character  /  attribute  at  cursor  position 

10 

AH 

Write  character  at  cursor  position 

11 

BH 

Determine  color  palette  for  graphic  mode 

12 

CH 

Set  display  point  in  graphic  mode 

13 

DH 

Sense  display  point  in  graphic  mode 
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Decimal 

Hex 

Meaning 

14 

EH 

Character  output  (like  a  terminal) 

15 

FH 

Determine  video  mode 

19 

13H 

Write  character  string  (only  available  on  AT) 

As  always,  the  processor  registers  pass  the  function  arguments.  Some  common 
rules  define  which  registers  accept  which  arguments: 

The  AH  register  indicates  the  number  of  the  function  to  be  called  with  interrupt 
iOH.  If  character  should  be  displayed,  or  a  dot  placed  on  the  screen  in  graphic 
mode,  its  value  passes  to  the  AL  register. 

Hercules  functions 

If  the  function  expects  display  coordinates  for  text  mode,  the  X-coordinate 
(column)  must  be  loaded  into  the  DL  and  the  Y-coordinate  (line)  into  the  DH 
register.  In  graphic  mode  the  CX  register  accepts  the  X-coordinate  and  the  DX 
register  the  Y-coordinate.  The  number  of  the  display  page  (if  required)  should  be 
contained  in  the  BH  register. 

It  is  important  for  assembler  programmers  that  the  contents  of  the  BX,  CX,  DX 
and  the  contents  of  the  segment  registers  remain  the  same  before  and  after  the 
interrupt  call.  The  contents  of  all  other  registers  may  change. 

Function  OH:  Set  video  mode 

Before  sending  output  to  the  screen,  the  video  mode  must  be  selected.  The  current 
video  mode  in  use  might  not  be  the  one  you  desire.  Function  0  of  interrupt  lOH 
performs  this  task  and  also  selects  the  active  video  card  in  case  the  PC  has  several 
video  cards  connected.  For  a  call  to  this  function  through  interrupt  lOH,  the  AH 
register  must  contain  function  number  0  and  the  AL  register  must  contain  the 
number  of  the  video  mode  to  be  activated.  Of  course  only  those  video  modes  that 
are  supported  by  the  video  card  in  the  PC  can  be  activated.  The  following  numbers 
correspond  to  the  various  video  modes  (the  video  card  supporting  the  mode  is  in 
parentheses): 


0 

40*25  character  monochrome  text  display 

(Color) 

1 

40*25  character  color  text  display 

(Color) 

2 

80*25  character  monochrome  text  display 

(Mono) 

3 

80*25  character  color  text  display 

(Color) 

4 

320*200  pixel  graphics  with  4  colors 

(Color) 

5 

~ 

320*200  pixel  graphics  with  4  colors 
but  shown  monochrome 

(Color) 

640*200  pixel  graphics  with  2  colors 

(Color) 

The  mode  makes  no  difference  on  a  monochrome  card,  since  only  one  mode  exists 
(80x25);  this  mode  is  constantly  active.  It  uses  the  internal  designation  number  of 
7. 
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Function  OFH:  Get  video  mode 

The  opposite  of  this  function  is  function  OFH,  which  detennines  the  current  video 
mode.  A  value  of  OFH  in  the  AH  register  during  a  call  to  interrupt  lOH  executes 
this  function.  It  returns  the  value  of  the  video  mode  (refer  to  the  table  above)  in  the 
AL  regist^.  As  mentioned  above,  a  monochrome  card  always  returns  the  value  7. 
Besides  the  video  mode,  the  number  of  columns  per  display  line  in  this  mode  (40 
or  80)  returns  in  the  AH  register  and  the  current  display  page  number  in  the  BH 
register. 

Function  02H:  Set  cursor  position 

Aft^  the  video  mode  initialization,  screen  output  can  begin.  Function  2  defines  the 
cursor  position.  Calling  this  function  places  the  blinking  cursor  in  the  desired 
location  on  the  screen.  This  sets  the  starting  position  of  character  display.  Prior  to 
calling  this  function  the  AH  register  should  be  loaded  with  the  function  number 
(2),  the  DH  register  with  the  line  location  of  the  cursor,  and  the  DL  register  with 
the  column  location  of  the  cursor.  The  BH  register  holds  the  display  page  onto 
which  the  cursor  should  be  positioned.  Remember  that  every  display  page  has  its 
own  cursor  for  positioning  the  text  output,  but  only  one  active  or  blinking  display 
cursor  exists.  This  active  cursor  always  appears  on  the  currently  displayed  page. 
Function  2  moves  the  active  cursor  if  the  value  in  the  BH  register  corresponds  to 
the  current  screen  page. 

Function  OSH:  Read  cursor  position 

The  counterpart  of  this  function  is  function  03H.  It  reads  the  current  cursor 
position  of  a  selected  display  page  and  returns  the  position  to  the  calling  program. 
At  the  call  of  this  function  the  AL  register  must  contain  the  function  number  (3) 
and  the  BH  register  the  number  of  the  display  page  whose  cursor  position  is  being 
read. 

Monochrome  display  cards  return  a  value  of  0,  since  the  card  can  only  display  one 
page  (numbered  0).  After  the  call  of  interrupt  lOH  the  DH  register  contains  the 
cursor  position's  line  and  the  DL  register  the  cursor  position's  column.  In  addition, 
two  values  are  returned  to  the  CH  and  CL  registers  which  have  special 
significance.  They  indicate  the  starting  and  ending  raster  scan  (pixel)  lines  of  the 
cursor.  These  lines  are  independent  of  the  displayed  page. 

To  understand  this  significance,  it  is  important  to  know  that  every  text  mode 
character  on  color  and  monochrome  cards  have  heights  of  8  and  14  pixels  per 
character,  respectively.  The  programmer  can  choose  at  which  of  these  pixel  lines 
the  blinking  cursor  begins  and  at  which  it  stops. 
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These  values  must  of  course  remain  within  the  legal  values  of  the  individual  video 
cards  (i.e.,  0  to  7  for  a  color  card  and  0  to  13  for  a  monochrome  card),  otherwise 
the  blinking  text  cursor  may  disappear  from  the  screen. 

Function  01 H:  Define  cursor  size 

While  these  values  are  read  with  the  help  of  function  3,  function  1  is  used  to  set 
these  values.  The  AH  register  loads  with  a  1,  the  CH  register  with  the  starting  line 
of  the  cursor,  and  the  CL  register  with  the  ending  line  of  the  cursor,  before  calling 
interrupt  lOH.  The  starting  line  must  be  smaller  than  or  equal  to  the  ending  line, 
or  the  cursor  becomes  invisible. 

Function  OSH:  Set  active  display  page 

This  book  has  frequently  mentioned  the  current  display  page  without  telling  how 
to  activate  this  page.  Function  OSH  of  intOTupt  lOH  performs  this  task.  Place  a 
value  of  5  in  the  AH  register  and  the  number  of  the  page  you  want  activated 
(displayed  on  the  monitor)  in  the  AL  register.  The  number  of  the  page  to  activate 
depends  on  how  many  pages  are  available  in  the  current  video  card  and  video  mode. 
Since  the  monochrome  video  card  offers  only  one  display  page,  using  this  function 
with  a  monochrome  card  makes  no  sense  at  all.  The  following  values  are  allowed 
te  the  color  card's  different  video  modes: 

0  to  7  (40*25  character  text  display  [Color-card]) 

0  to  3  (80*25  character  text  display  [Color-Card]) 

After  selecting  the  video  mode  and  moving  the  cursor  to  the  desired  location  on  the 
screen,  one  or  more  characters  are  output  on  the  screen  in  most  cases.  BIOS  makes 
various  functions  available  which  have  different  abilities  in  providing  character 
display  on  the  screen.  One  difference  between  these  functions  is  that  they  process 
control  codes  in  various  ways.  These  control  codes  are  the  ASCII  codes  7,  8, 10 
and  13.  They  represent  the  following: 


7 

Bell 

produces  a  sound 

8 

Backspace 

erases  preceding  character  &  moves 
cursor  back  one  character  position 

Linefeed 

moves  cursor  one  line  down 

EEH 

Carriage  return 

moves  cursor  to  start  of  current  line 

Some  functions  view  these  codes  as  normal  ASCII  characters  and  execute  them 
accordingly.  Other  functions  see  them  as  control  codes.  For  example,  code  7 
produces  a  sound  with  some  functions.  The  choice  of  which  function  to  use 
depends  on  which  control  code  processing  is  desired. 

Text  display  in  graphic  mode 

Text  display  functions  can  be  used  in  both  text  and  graphic  modes.  Text  output  in 
gr2q)hic  mode  creates  different  characters  since  the  characters  must  be  drawn  on  the 
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screen  from  pixels.  The  PC  uses  ASCII  codes  to  set  the  graphic  pixels.  While  the 
character  samples  for  the  ASCII  codes  0  to  127  are  already  stored  in  the  ROM,  the 
character  patterns  for  the  codes  128  to  2SS  must  be  read  from  a  table  in  RAM. 
This  table  installs  itself  in  RAM  when  you  execute  the  DOS  GRAFTABL 
command. 

BIOS  obtains  the  address  of  this  t^le  from  the  memory  locations  0000:007C  to 
0000:007F,  who-e  the  table’s  offset  address  lies  in  the  lower  two  bytes  and  the 
table’s  segment  address  in  the  upper  two  bytes.  These  memory  locations  are  inside 
the  interrupt  vector  table  but  can  be  used  for  this  purpose  since  interrupt  IFH 
(whose  adcbess  normally  appears  th^)  remains  unused. 

Having  this  table  stored  in  RAM  makes  it  possible  to  define  your  own  table,  so 
that  special  characters  which  are  not  contained  in  the  standard  character  set  can  be 
displayed  on  the  screen.  Since  every  character  is  comprised  of  8  bytes,  the  first  8 
bytes  of  the  table  are  reserved  for  ASCII  code  128,  the  next  8  for  the  code  129,  etc. 
Each  byte  contains  the  bit  pattern  for  one  of  the  8  lines  which  compose  a 
character.  Bit  0  represents  the  dot  on  the  right  border  of  the  character  matrix,  bit  7 
the  dot  on  the  left  border.  If  you  set  a  bit  to  1,  this  illuminates  the  corresponding 
pixel  on  the  screen. 

Function  OSH:  Write  character  with  attribute 
Function  OAH:  Write  character 

Functions  09H  and  OAH  are  available  for  character  output.  Function  OAH  displays 
the  character  in  the  color  determined  oy  the  attribute  corresponding  to  that 
particular  screen  position.  Function  09H  sets  the  color  (attribute)  of  the  character 
to  be  displayed.  Neither  function  moves  the  cursor  to  the  next  screen  position  after 
character  display.  Character  output  resumes  at  the  same  location  on  the  next 
function  call.  Function  02H  must  be  called  to  move  the  cursor  to  the  next  screen 
position  for  displaying  readable  text 

Determining  the  function  call 

Both  functions  09H  and  OAH  interpret  the  control  codes  described  above  as  normal 
characters  and  display  them  accordingly.  During  the  call  of  these  functions  the 
contents  of  the  AH  register  depend  on  whether  the  user  called  function  09H  and 
OAH.  The  AL  register  accepts  the  ASCII  code  of  the  character  to  be  displayed.  The 
display  page  for  character  ^splay  can  be  found  in  the  BH  register.  The  CX  register 
contains  a  number  which  indicates  how  many  times  the  character  should  be 
displayed.  Because  of  this,  it’s  possible  to  display  a  character  several  times  with 
just  one  interrupt  call  (this  saves  time  and  memory).  If  you  want  the  charactCT  in 
the  AL  register  displayed  only  once,  a  1  must  be  stored  in  the  CX  register  during 
the  function  call.  Since  function  09H  also  determines  the  color  of  the  charact^  to 
be  output,  the  BL  register  passes  the  character  color. 
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Function  OEH:  Teletype  mode 

A  serious  disadvantage  of  these  two  functions  is  that  the  cursor's  position  does  not 
advance  after  the  function  call.  Function  OEH  cures  this  problem.  It  acts  like  a 
terminal,  hence  its  name — ^the  TTY  (Teletype  output)  routine.  The  cursor  advances 
to  the  next  screen  position  after  a  character  is  displayed.  If  the  cursor  reaches  the 
end  of  the  screen  line,  it  moves  to  the  beginning  of  the  following  line.  If  the 
cursor  is  in  the  last  display  screen  position  (line  24,  column  79),  the  entire  screen 
is  scrolled  one  line  upward  and  the  top  line  of  the  screen  disappears  from  the 
display  area.  In  addition,  the  function  clears  line  24  and  the  cursor  moves  to  the 
beginning  of  the  line. 

Another  approach  to  control  codes 

Unlike  functions  09H  and  OAH,  function  OEH  treats  control  codes  according  to 
their  functions,  and  not  as  normal  ASCII  codes.  Like  function  OAH,  characters  are 
displayed  by  function  OEH  using  the  character  color  (attribute)  already  present  at 
that  screen  location.  This  is  valid  for  text  mode  only.  In  graphic  mode,  the 
foreground  color  must  be  passed  in  the  BL  register. 

Prior  to  the  function  call,  the  AH  register  must  be  loaded  with  function  number 
OEH,  the  AL  register  loaded  with  the  code  of  the  character  to  be  displayed  and  the 
BH  register  with  the  display  page  intended  for  character  display. 

Function  OSH:  Read  character/attribute 

While  functions  09H,  OAH  and  OEH  display  characters  on  the  screen,  function  OSH 
makes  it  possible  to  read  characters  from  the  screen,  i.e.,  to  sense  the  character  and 
attribute  displayed.  Before  the  call,  the  value  08  must  be  loaded  into  the  AH 
register  and  the  number  of  the  display  page  from  which  the  character  should  be 
loaded  into  the  BH  register.  The  display  position  from  which  the  character  should 
be  read  is  the  current  cursor  position  in  the  display  page  indicated  by  the  BH 
register. 

In  text  mode  the  character  code  can  be  read  directly  from  video  RAM.  However, 
graphic  mode  requires  a  comparison  between  the  bit  pattern  at  the  current  cursor 
position  and  every  character's  bit  pattern  in  the  character  set 

After  the  function  call,  the  AH  register  contains  the  attribute  (color)  and  the  AL 
register  ccHitains  the  ASCII  code  of  the  character  read. 

Function  06H:  Scroll  window  up 

Function  06H  scrolls  the  screen  up  one  or  more  lines,  or  clears  sections  of  the 
screen  by  displaying  spaces  (ASCII  code  32).  These  operations  can  only  be 
performed  on  the  current  display  page.  To  call  this  function,  you  must  load  the  AH 
register  with  the  function  number  (6).  The  AL  register  is  loaded  with  the  number 
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of  lines  the  display  should  be  moved  up.  A  0  in  this  registo*  instructs  the  function 
to  fill  the  screen  area  with  spaces  instead  of  scrolling  the  screen.  The  BH  register 
contains  the  color  (attribute)  for  the  blank  line.  The  CH,  CL,  DH  and  DL  registers 
define  the  display  page  window  to  be  scrolled  or  cleared.  The  C  register  rqrresents 
the  upper  left  comer  of  the  window,  while  the  D  register  defines  the  lower  right 
comer  of  the  window.  The  following  list  illustrates  the  meaning  of  each  register 


Req 

Meaninq 

CH 

Line  of  the  upper  left  corner  of  the  window 

CL 

Column  of  the  upper  left  corner  of  the  window 

DH 

Line  of  the  lower  riqht  corner  of  the  window 

DL 

Column  of  the  lower  riqht  corner  of  the  window 

Function  07H:  Scroll  window  down 

Function  07H  scrolls  the  screen  down  one  or  more  lines,  or  clears  sections  of  the 
screen  by  displaying  spaces  (ASCII  code  32).  These  operations  can  only  be 
performed  on  the  current  display  page.  To  call  this  function,  you  must  load  the  AH 
register  with  the  function  number  (7).  The  AL  regista  is  loaded  with  the  number 
of  lines  the  display  should  be  moved  down.  A  0  in  this  register  instracts  the  func¬ 
tion  to  fill  the  screen  area  with  spaces  instead  of  scrolling  the  screen.  The  BH 
register  contains  the  color  (attribute)  for  the  blank  line.  The  CH,  CL,  DH  and  DL 
registers  define  the  display  page  window  to  be  scrolled  or  cleared.  The  C  register 
represents  the  upper  left  comer  of  the  window,  while  the  D  register  defines  the 
lower  right  comer  of  the  window.  The  following  list  illustrates  the  meaning  of 
eachiegisten 


Req 

Meaninq 

CH 

Line  of  the  upper  left  corner  of  the  window 

CL 

Column  of  the  upper  left  corner  of  the  window 

DH 

Line  of  the  lower  riqht  corner  of  the  window 

DL 

Column  of  the  lower  riqht  corner  of  the  window 
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Graphic  functions 

The  following  are  descriptions  of  the  functions  used  in  the  different  gr^hic  modes. 
They  can  be  used  in  connection  with  video  cards  capable  of  producing  gn^hics. 

Function  OOH:  Set  video  mode 

Function  OOH  switches  on  one  of  the  available  graphic  modes.  The  border  color  (ot 
color  palette)  should  then  be  selected  for  the  320x200  (or  text)  mode  by  loading 
function  number  OAH  in  the  AH  register.  The  BH  register  dictates  the  use  of  the 
border  color  or  the  color  palette.  If  during  the  function  call  the  BH  register  contains 
a  0,  the  value  in  the  BL  register  becomes  the  background  and  bordo*  color  for  the 
graphic  mode.  All  16  colors  are  available,  so  the  BL  regist^  can  contain  a  value 
between  0  and  15.  This  function  remains  valid  for  the  text  mode.  However,  only 
the  border  color  can  be  set.  The  background  color  for  each  character  is  set 
individually  by  the  top  4  bits  of  the  color  attribute,  and  therefore  cannot  be  set  for 
everything. 

If  the  BH  register  contains  a  1,  the  value  in  the  BL  register  (0  or  1)  selects  the 
active  color  palette.  The  palettes  contain  the  following  colors: 


IIHHI 

Function  OBH:  Set  color  palette 

Once  the  graphic  mode  initializes  and  the  colors  are  selected,  graphic  drawing  can 
begin.  Function  OBH  writes  graphic  pixels  at  specified  locations  of  the  screen.  The 
pixel  coordinates  to  be  addressed  are  passed  in  the  CX  and  DX  registers.  The  values 
in  these  registers  depend  on  the  graphic  resolution  of  the  current  gi^hic  mode.  The 
CX  register  contains  the  X-coordinate  (column  coordinate)  of  the  pixel,  and  the  DX 
register  the  Y-coordinate  (line  coordinate)  of  the  pixel.  The  function  call  must  have 
the  function  number  (OBH)  passed  in  the  AH  register.  The  color  value  of  the  pixel 
to  be  manipulated  is  passed  in  the  AL  register.  The  Hercules  card  and  the  64ta200 
mode  of  the  color  card  permit  the  values  0  and  1  only.  In  the  320x200  mode  of  the 
color  card,  the  values  0  to  3  are  allowed  fex*  the  4  possible  colors.  The  significance 
of  these  values  depends  on  the  active  color  palette.  If  a  program  enables  palette  0, 
the  values  have  the  following  significance: 


0 

Color  selected  for  background  with  function  OBH 

1 

Green 

2 

Red 

3 

Yellow 
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An  active  palette  1  changes  the  values  slightly: 


0 

Color  selected  for  backqround  with  function  OBH 

1 

Cyan 

2 

Magenta 

3 

White 

Function  ODH:  Read  pixel 

Function  ODH  is  the  equivalent  of  this  function,  which  determines  the  color  value 
of  a  pixel.  Before  the  call,  the  value  ODH  must  be  passed  in  the  AH  register,  the 
X-coordinates  of  the  pixel  must  be  loaded  into  the  CX  register,  and  the  Y- 
coordinates  into  the  DX  register.  The  pixel  color  is  returned  as  a  result  in  the  AL 
register.  This  value  corresponds  to  the  rules  described  in  function  OBH. 

Function  13H:  Write  string 

Interrupt  lOH  includes  another  function  on  AT  computers.  Function  13H  displays 
strings  of  characters  on  the  screen.  During  its  call  a  series  of  arguments  must  be 
passed,  in  addition  to  passing  the  function  number  to  the  AH  register.  The  BH 
register  accepts  the  number  of  the  display  page  on  which  the  string  should  be 
displayed  (not  necessarily  the  current  display  page).  The  starting  position  of  the 
character  string  on  the  display  is  in  the  DH  (line)  register  and  the  DL  register 
(column).  The  CX  register  contains  the  number  of  characters  in  the  character 
string. 

The  AL  register’s  contents  define  one  of  the  four  possible  modes  in  which  the 
character  string  can  be  displayed.  The  string  format  in  modes  0  and  1  differ  from 
string  format  in  modes  2  and  3.  Modes  2  and  3  place  attribute  bytes  after  every 
character  in  the  string.  In  modes  0  and  1,  the  individual  characters  of  the  string 
follow  one  another  in  sequence.  The  attribute  byte  for  all  characters  depends  on  the 
contents  of  the  BL  register.  In  modes  2  and  3,  2  bytes  are  stored  in  the  string  for 
every  character  displayed.  For  example,  a  character  string  of  4  characters  requires  8 
bytes  of  memory.  The  number  of  characters  to  be  displayed  (4  characters  in  this 
example)  must  be  indicated  in  the  CX  register.  Another  difference  between  modes  0 
and  2  and  modes  I  and  3  is  in  display  format.  After  the  string  display  in  modes  1 
and  3,  the  cursor  appears  following  the  last  character  of  the  string.  The  next 
character  displayed  with  one  of  the  BIOS  functions  then  appears  at  this  position  on 
the  screen.  The  cursor  position  does  not  get  updated  in  modes  0  and  2. 
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Demonstration  programs 

The  following  programs  demonstrate  the  use  of  BIOS  video  interrupt  functions 
available  from  higher  level  languages.  In  Pascal  and  C,  you'll  find  that  using  BIOS 
display  functions  works  much  faster  than  the  standard  procedures  and  functions 
provided  in  these  languages,  which  use  the  slower  DOS  functions.  BASIC's  use  of 
BIOS  screen  functions  is  minimal,  since  these  functions  are  even  slower  than  the 
BASIC  PRINT  statement 


Advantage 

Accessing  BIOS  video  interrupt  functions  has  an  advantage  over  the  use  of  onboard 
graphic  commands  in  higher  level  languages:  the  BIOS  functions  can  be  accessed 
at  any  time. 

Disadvantage 

There  is  a  serious  disadvantage  to  using  BIOS  functions  for  screen  output.  The 
higher  level  language  display  commands  can  accept  numerical  variables,  which  are 
then  converted  to  ASCII  characters.  These  higher  level  commands  can  format  the 
variables  according  to  decimal  places  or  a  certain  degree  of  precision,  then  display 
these  variables.  However,  if  numerical  variables  are  to  be  displayed  using  the  BIOS 
functions,  they  must  first  be  converted  into  a  character  string  which  you  must 
transfer  to  the  BIOS  output  function.  This  procedure  takes  time. 

All  three  programs  are  identical  in  function.  Each  fills  the  screen  with  continuous 
characters  from  the  PC  character  set,  then  opens  two  windows  in  which  two  arrows 
move  up  and  down.  How  this  was  done,  and  how  it  will  actually  appear  on  the 
screen,  should  become  clear  after  you  take  a  closer  look  at  the  program  codes.  The 
programs  limit  their  access  to  one  video  page,  due  to  incompatibility  problems 
that  could  occur  between  monochrome  and  color  cards.  They  also  do  not  present 
subroutines,  functions  or  procedures  for  calling  the  BIOS  graphic  functions. 


Once  you  understand  this  section  you  should  be  able  to  easily  add  the  missing 
functions  and  even  write  a  short  demo  program  of  your  own.  Using  BIOS  video 
interrupt  assures  that  the  computer  will  not  crash  and  that  nothing  major  can  go 
wrong. 

BASIC  listing:  VIDEOB.BAS 

100  •***************************-k************************************** 

110  •*  VIDEOS  BAS  *• 

120  •* - *• 

130  '*  Task  :  Makes  some  Subroutines  available  for  access  *' 

140  '*  to  the  Display  using  the  BlOS-Video-Interrupt  *' 

150  •*  *• 

160  •*  Author  :  MICHAEL  TISCHER  *• 

170  '*  developed  on  :  07/18/87  *' 

180  •*  last  Update  :  05/14/89  *• 

190  •★★★★★★★★★★★★★★★★★★★★★★★★★*************★★★★★★★★★★★★★★★★★★★★★★★★★★★• 

200  • 

210  CLS  :  KEY  OFF 

220  PRINT "WARNING:  This  Program  should  only  be  started  if  GWBASIC  was  « 
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230  PRINT-started  from  the  DOS  level  with  <GWBASIC  /m:60000>. 
240  PRINT  :  PRINT''If  this  was  not  the  case  enter  <s>  for  Stop.” 
250  PRINT''Otherwise  press  any  key...''; 

260  A$  =  INKEYS  :  IF  AS  =  "s"  THEN  END 
270  IF  AS  =  ""  THEN  260 
280  CLS 

290  GOSUB  60000 
300  PAGE%=0 
310  COLRR%=7 

320  FOR  DISPR0W%*1  TO  24 
330  FOR  DISPCOL%=0  TO  79 


340 

350 

360 

370 


'Install  function  for  interrupt  call 
•Display  page  for  the  output  is  Page  0 
' light  characters  on  dark  background 
•process  all  display  lines 
'process  all  display  columns 
CHARACTERS*CHRS( (DISPCOL%+DISPROW%*80)  AND  255) 'continuous  code 

'Set  cursor  position 
•Output  character 
•next  column 
•next  line 
'Erase  Window 
'Coordinates  of  the  1.  Window 
•Erase  Window 
'Coordinates  of  the  2.  Window 
'Erase  Window 

'dark  letters  on  light  background  (inverse) 
'Coordinates  for  Text  output 
•Text  for  output 
•Output  Text 
•Coordinates  for  text  output 
•Text  for  output 
'Output  Text 
'upper  left  Display  corner 


GOSUB  52000 
GOSUB  57000 
NEXT 
380  NEXT 
390  VALUE%=0 
400  ULC%=5  :  ULR%=8 
410  GOSUB  55000 
420  ULC%=60  ;  ULR%=2 
430  GOSUB  55000 
440  COLRR%=&H70 
450  DISPCOL%=5  :  DISPROW%=8 
460  T$=''  Window  1 
470  GOSUB  58000 
480  DISPCOL%=60  ;  DISPROW%=2 
490  T$="  Window  2 
500  GOSUB  58000 
510  DISPROW%=0  :  DISPCOL%=0 


LRC%=19  :  LLR%=22 


:  LRC%=74  :  LLR%=16 


520  T$=STRING$(23,"  ")+''Arrow  number _  is  being  drawn  "+STRING$  (23,  ••  •') 

530  GOSUB  58000  'Output  Text 

540  COLRR%=&HF0  'dark  chars  on  light  background  (inverse)  blinking 

550  DISPCOL%=24  :  DISPROW%=12  'Coordinates  for  Text  output 

560  T$="  »>  PC  SYSTEM  PROGRAMMING  «<  "  'Text  for  output 

570  GOSUB  58000  'Output  Text 

580  VALUE%=1  'always  scroll  one  line 

590  FOR  ARROWS%=4  TO  0  STEP  -1  'Output  total  of  10  Arrows 

600  DISPCOL%=35;  DISPROW%=0  'Position  for  number  of  Arrows 

610  COLRR%=&H70  'dark  characters  on  light  backgiound  (inverse) 

620  T$=STR$ (ARROWS%)  'Convert  number  of  Arrows  into  ASCII-String 

630  GOSUB  58000  'Output  Text 

640  COLRR%=7  'light  characters  on  dark  background 

650  FOR  COUN'i’L%=l  TO  8  'an  Arrow  consists  of  8  Lines 

660  DISPCOL%=5  :  DISPROW%=9  'Coordinates  in  first  Window 

670  T$=STRING$(8-COUNTL%, "  ") +STRING$ (2*C0UNTL%-1 , "*") +STRING$ (8-C0UNTL%/'  ") 
680  GOSUB  58000  'Output  Arrow  line 

690  DISPCOL%=60  ;  DISPROW%=16  'Coordinates  in  second  Window 

700  GOSUB  58000  'Output  arrow  line 

710  ULC%=5  :  ULR%=9  :  LRC%=19:  LLR%=22  'Coordinates  of  1.  Window 

720  VALUE%=1  'scroll  one  DISPROW 

730  GOSUB  56000  'Scroll  Window  down 

740  ULC%=60  :  ULR%=3  :  LRC%=74:  LLR%=16  'Coordinates  of  2.  Window 

750  VALUE%=1  'Scroll  one  Line 

760  GOSUB  55000  'Scroll  Window  up 

770  NEXT  'next  Arrow  Line 

780  NEXT  'next  Arrow 

790  CLS 
800  KEY  ON 
810  END 
820  ' 

50000 
50010 
50020 
50030 
50040 
50050 
50060 
50070 
50080 
50090 


Sense  Video  mode  and  other  Parameters 


Input 

Output 


*  Info 


none 

VM0DE%  =  the  current  Video  mode 
PAGE%  =  the  current  Display  page 
DISPCOL%  =  the  number  of  Columns  per  Line 
the  Variable  Z%  is  used  as  Dummy 
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50100 

50110 

50120 

50130 

50140 

51000 

51010 

51020 

51030 

51040 

51050 

51060 

51070 

51080 

51090 

51100 

51110 

51120 

51130 

52000 

52010 

52020 

52030 

52040 

52050 

52060 

52070 

52080 

52090 

52100 

52110 

52120 

52130 

52140 

52150 

52160 

52170 

52180 

53000 

53010 

53020 

53030 

53040 

53050 

53060 

53070 

53080 

53090 

53100 

53110 

53120 

53130 

53140 

53150 

54000 

54010 

54020 

54030 

54040 

54050 

54060 

54070 

54080 

54090 

54100 

54110 

54120 

55000 

55010 

55020 


DISPCOL%=15  'Get  Function  number  for  Video  mode 

INR%»&H10  'Call  BlOS-Video-Interrupt  16(h) 

CALL  lA (INR%,  DISPCOL%, VMODE%, PAGE%, Z%, Z%, Z%,  Z%,  Z%,  Z%, Z%,  Z%,  Z%) 
RETURN  'back  to  caller 

•★**★★*★★**★*★**★★★★****★★*********★★★★*★★★★★★★★★★*****★★**★★★**• 
'*  Define  appearance  of  blinking  Text-Cursor  *' 


'*  Input  :  BEGLIN%  =  is  the  beginning  Line  of  the  Text -Cursor  *' 
'*  ENDL%  =  is  the  End  Line  of  the  Text -Cursor  *' 

•  *  Output :  none  * ' 

'*  Info  :  the  Variable  Z%  is  used  as  Dummy  *' 

t*******-k-k-k******1fk1fk1fk***1t1t**********1fk*it***it******************* 

I 

FKT%*1  'Set  Function  number  for  appearance  of  Cursor 

INR%=&H10  'Call  BlOS-Video-Interrupt  16(h) 

CALL  lA (INR%, FKT%, Z%, Z%, Z%, BEGLIN%, ENDL%,  Z%, Z%,  Z%, Z%,  Z%, Z%) 

RETURN  'back  to  caller 


'*  Set  Cursor  Position  * 


' *  Input 


'*  Output 
'*  Info 


PAGE%  =  is  the  Number  of  the  Display  page  * 
DISPCOL%  =  is  the  new  Column  of  the  Cursor  * 
DISPR0W%  =  is  the  new  Row  of  the  Cursor  * 
none  * 
The  position  of  the  blinking  Text-Cursor  is  only  * 
influenced  by  the  call  of  this  subroutine  if  the  * 
Display  page  Indicated  is  the  current  Display  page  * 


'*  the  Variable  Z%  is  used  as  Dummy  * 

I *************************************************************** 


FKT%=2  'Set  Function  number  for  Cursor  position 

INR%»&H10  'Call  BlOS-Video-Interrupt  16(h) 

CALL  lA (INR%, FKT%, Z%, PAGE%, Z%, Z%, Z%, DISPR0W%, DISPCOL%, Z%,  Z%,  Z%,  Z%) 
RETURN  'back  to  caller 


•  ★★★★★★★★★★★★★★★★★★★★★★★*****************i>***********<t********** 

'*  Read  Cursor  Position  and  Beginning  and  End  Row  * 

'*  of  the  blinking  Text -Cursor  * 


' *  Input  :  PAGE%  =  is  the  Number  of  the  Display  page 

'*  Output:  DISPCOL%  =  Column  of  the  Cursor  in  the  Display  page 

**  DISPROW%  =  Row  of  the  Cursor  in  the  Display  page 

BEGLIN%  *  beginning  Line  of  the  Text -Cursor 
' *  ENDL%  =  is  the  End  Line  of  the  Text-Cursor 

'*  Info  :  the  Variable  Z%  is  used  as  Dummy 


FKT%=3  'Read  Function  number  for  Cursor  position 

INR%=&H10  'Call  BlOS-Video-Interrupt  16(h) 

CALL  lA (INR%, FKT%, Z%, PAGE%, Z%, BEGLIN%, ENDL%, DISPR0W%,  DISPCOL%, Z%, Z%, Z%, Z%) 
RETURN  'back  to  caller 


Set  the  current  display  page  on  the 
screen 


'*  Input  :  PAGE%  =  is  the  Number  of  the  Display  page  *' 

'*  Output:  none  *' 

**  Info  :  the  Variable  Z%  is  used  as  Dummy  *' 

•**★★★**★*★★*★**************************************★*****★★*★**■ 

FKT%=5  'Set  Function  number  for  Display  page 

INR%=&H10  'Call  BlOS-Video-Interrupt  16(h) 

CALL  lA (INR%, FKT%, PAGE%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%) 

RETURN  'back  to  caller 

• ***************************************************************** 

' *  Scroll  current  Display  page  up  or  erase  * ' 

•  * _ _ _ _ _ _ _ _ _ *  ' 
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55030 

55040 

55050 

55060 

55070 

55080 

55090 

55100 

55110 

55120 

55130 

55140 

55150 

55160 

55170 

55180 

55190 

56000 

56010 

56020 

56030 

56040 

56050 

56060 

56070 

56080 

56090 

56100 

56110 

56120 

56130 

56140 

56150 

56160 

56170 

57000 

57010 

57020 

57030 

57040 

57050 

57060 

57070 

57080 

57090 

57100 

57110 

57120 

57130 

57140 

57150 

57160 

57170 

57180 

58000 

58010 

58020 

58030 

58040 

58050 

58060 

58070 

58080 

58090 

58100 

58110 

58120 

58130 

58140 

58150 


•*  Input  :  VALUE% 

•  *  ULC% 

•  *  ULR% 

•  *  LRC% 

•*  LLR% 

•  *  COLRR% 


=  how  many  Lines  to  scroll 
=  Column  upper  left 
=  Row  upper  left 
=  Column  lower  right 
=  Row  lower  right 
=  COLRR  of  erased  Lines 


Output:  none 

Info  :  If  VALUE%  0  is  indicated,  the 
Display  area  is  erased 
the  Variable  Z%  is  used  as  Dummy 
★*★★★*****★**★*****★**★*★★*★**★★★★★*★★**★* 


********★★★*★**★• 


FKT%=6  'Function  number  for  scrolling  up 

INR%=&H10  'Call  BlOS-Video-Interrupt  16(h) 

CALL  IA(INR%,FKT%, VALUE%,COLRR%,Z%,ULR%,ULC%,LLR%,LRC%,  Z%,Z%,Z%,Z%) 
RETURN  'back  to  caller 


'*  Scroll  current  Display  Page  down  or  erase 


* 

Input  : 

VALUE% 

=  how  many  Lines  to  scroll 

*• 

* 

ULC% 

=  Column  upper  left 

*  • 

* 

ULR% 

=  Row  upper  left 

★  • 

* 

LRC% 

=  Column  lower  right 

*' 

* 

LLR% 

=  Row  lower  right 

*' 

* 

C0LRR% 

=  COLRR  of  erased  Lines 

*  • 

* 

Output : 

none 

★  • 

* 

Info  : 

If  VALUE%  0  is  indicated,  the 

* ' 

It 

Display 

area  is  erased 

*' 

'*  The  Variable  Z%  is  used  as  Dummy  * 


FKT%=7  'Function  number  for  scrolling  down 

GOTO  55160  'Call  is  identical  with  scrolling  up 


**************************************************************** 
'*  Write  a  character  of  a  designated  COLRR  to  the  current  * 

'*  Cursor  position  in  the  designated  Display  Page  * 


'*  Input  :  CHARACTERS  =  the  character  for  output  * 
' *  C0LRR%  =  COLRR  of  the  character  for  output  * 
' *  PAGE%  =  is  the  Number  of  the  Display  page  * 
'*  Output:  none  * 
'*  Info  :  the  Variables  ZL%,  ZH%  and  ZE%  are  Dummies  * 
• **************************************************************** 


FKT%=9  'Output  function  numbers  for  character  and  Attribute 

INR%=&H10  'Call  BlOS-Video-Interrupt  16(h) 

ZL%=1  'Output  character  only  once  (LO-Byte) 

ZH%=0  'Output  character  only  once  (HI-Byte) 

ZE%=ASC (CHARACTERS)  'Get  ASCII-Code  of  character  to  be  output 

CALL  lA ( INR% , FKT% , ZE% , PAGE% , C0LRR% , ZH% , ZL% ,  ZL% ,  ZL% ,  ZL% ,  ZL% , ZL% , Z L% ) 
RETURN  'back  to  caller 


I*************************************************************** 

'*  Output  a  String  starting  at  a  certain  Position  within  a  * 
'*  Display  page  with  a  constant  Attribute  * 


'*  Input  :  TS  =  the  String  for  output  *' 

'*  COLRR%  =  COLRR  of  the  String  (Attribute)  *' 

'*  PAGE%  =  is  the  number  of  the  Display  page  *' 

'*  DISPC0L%  =  Column  -  start  of  String  *' 

'*  DISPROW%  =  Row  -  start  of  String  *' 

' *  Output :  none  * ' 

' *  Info  :  the  Variables  ZC%  and  ZE%  are  Dummies  * ' 

***************************************************************** 

I 

GOSUB  52000  'Set  Cursor  position  for  Output 

FOR  ZC%=1  TO  LEN(TS)  'process  all  chars  or  strings  individually 
CHARACTERS="  "  'output  a  blank  first 
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58160 

58170 

58180 

58190 

58200 

58210 

58220 

60000 

60010 

60020 

60030 

60040 

60050 

60060 

60070 

60080 

60090 

60100 

60110 

60120 

60130 

60140 

60150 

60160 

60170 

60180 

60190 

60200 

60210 

60220 

60230 


GOSUB  57000 

ZE%=ASC (MID$(T$, ZC%, 1) )  'Get  a  character  from  the  String 

FKT%*14  'Function  number  for  Teletype-Output 

CALL  lA (INR%, FKT%, ZE%, PAGE%, Z%, Z%, Z%,  Z%,  Z%,  Z%,  Z%,  Z%,  Z%) 

NEXT  'Output  next  character 

RETURN  'back  to  caller 

'*  initialize  the  Routine  for  the  Interrupt  call  *' 


'*  Input  :  none  *' 

'*  Output:  lA  is  the  Start  address  of  the  Interrupt -Routine  *' 


IA=60000!  'Start  address  of  the  Routine  in  the  BASIC-Segment 

DEF  SEG  'Set  BASIC  Segment 

RESTORE  60130 

FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'poke  Routine 
RETURN  'back  to  caller 

DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 

DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 

DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 
DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 
DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 


The  program  can  be  divided  into  three  parts.  Lines  100  to  700  represent  the 
demonstration  program  proper,  which  uses  the  subroutines  in  lines  50000  to 
58220.  These  subroutines  call  a  special  function  of  the  BIOS  video  interrupt  and 
access  the  routine  for  interrupt  calls  as  described  earlier.  The  program  DATA 
begins  on  line  60000. 


See  the  header  of  each  subroutine  for  the  variables  of  each  subroutine  and  what 
each  variable  does. 


It  should  be  noted  that  all  subroutines  receive  and  return  numerical  values  as 
integer  variables.  Do  not  forget  the  percentage  character  after  a  variable.  In  certain 
cases  a  real  variable  of  the  same  name  can  be  initialized,  but  the  subroutine 
expected  an  integer  variable  and  the  wrong  parameters  will  be  passed  to  the  BIOS 
function. 

Pascal  and  C  implementations 

The  individual  functions  and  procedures  of  the  next  two  programs  are  fully 
documented  and  should  be  self-explanatory.  The  two  programs  resemble  each  other 
strongly,  since  the  procedures,  functions  and  variables  have  the  same  names. 
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Pascal  listing:  VIDEOP.PAS 

^  **★***★**★******★*★★★*★★***★*★★***★★★★***★*★★*★★★*★★**★★**★**★★*★★*★*} 


{*  V  I  D  E  0  P  PASCAL  *} 

- *} 

{*  Task  :  makes  functions  available  which  are  *} 

{*  based  on  the  BlOS-Video-Interrupt  but  are  not  *} 

{*  provided  by  PASCAL  *} 

{* - *} 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  on  :  07/10/87  *} 

{*  last  Update  :  05/14/89  *} 


{*★*★★******★ ***★*★★*****★★*★***★★***★★★★*★*★*********★***★* ★★******★*} 
program  VIDEOP; 


Uses  Crt,  Dos;  {  Adds  DOS  and  CRT  units  to  Turbo  } 

const  NORMAL  =  $07;  {  Definition  of  character-attribute  } 

BOLD  =  $0f;  {  in  relation  to  a  monochrome  } 

INVERS  =  $70;  {  Display  card  } 

UNDERLINE  =  $01; 

BLINK  =  $80; 

type  TextTyp  =  string[80]; 

var  i,  {  Loop  variable  for  the  Main  program  } 

j, 

Jc, 

1  :  integer; 

IString  ;  string [2];  {  accepts  number  of  Arrows  } 

I ★★*★**★**★★**★********★★★****★******★★**★**★ ★★*★***★**★**★★**★★*★★***} 

{*  GETVIDEOiODE :  Read  current  Video  mode  and  Parameters  *} 

{*  Input  :  none  *} 

{*  Output  :  The  Variables  listed  below  get  the  values  after  the  *} 

{*  call  of  the  Procedure  *} 

^ ★*★★**★★★*★★**★**★*★★*****★★******★★*★★*****★**★★★*★****★*★★★**★*★*★★ j 

procedure  GetVideoMode (var  VideoMode,  {  Number  of  current  Video  mode  } 
Number,  {  Number  of  Columns  per  Line  } 

Page  :  integer) ;  {  current  display  page  } 

var  Regs  :  Registers;  {  Register-Variable  for  call  of  Interrupt  } 

begin 

Regs. ah  :=  $0F; 
intr($10,  Regs); 

VideoMode  :=  Regs.al; 

Number  :=  Regs. ah; 

Page  :=  Regs.bh; 
end; 


^ *★★★*★★*★★★*★★**★★*★★*★★★*★★***★***★*************★★★**★★★★★★★*★★★★★★* ^ 
{*  SETCURSORTYPE:  defines  the  appearance  of  the  blinking  *} 

{*  Display  cursor  *} 

{*  Input  :  see  below  *} 

{*  Output  ;  none  *} 

{*  Info  :  for  a  monochrome  display  card  the  parameters  *} 

{*  can  be  between  0  and  13,  for  a  color  display  *} 

{*  card  between  0  and  7  *} 

{ ★★★★★★★★*★★★★★★***★★*★★************************************«********* j 

procedure  SetCursorType (Beginllne,  {  Beginning  line  of  the  cursor  } 


Endl  :  integer) ;  {  End  line  of  the  cursor  } 

var  Regs  :  Registers;  {  Register  variable  for  the  Interrupt  call  } 


{  Function  number  } 
{  Call  BlOS-Video-Interrupt  } 
{  Number  of  Video  mode  } 

{  Number  of  characters  per  line  } 

{  Number  of  the  current  display  page  } 
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begin 

Regs. ah  :=  1; 

Regs.ch  :=  Beginline; 
Regs. cl  :=  Endl; 
intr($10,  Regs); 
end; 


{  Function  number  } 
{  Beginning  and  } 
{  End  line  } 
Call  BIOS-Video- Interrupt  } 


{*  SETCURSORPOS:  defines  the  position  of  the  cursor  in  the  *} 
{*  display  page  output  *} 
{*  Input  :  see  below  *} 
{*  Output  :  none  *} 
{*  Info  :  The  position  of  the  blinking  display  cursor  changes  *} 
{*  only  through  the  call  of  this  procedure,  if  the  *} 
{*  indicated  display  page  is  the  current  display  page  *} 


^*********************************************************************j 


procedure  SetCursorPos (Page,  {  display  whose  Cursor  is  set  } 

Column,  {  new  Column  of  the  Cursor  } 

Line  :  integer) ;  {  new  Line  of  the  Cursor  } 

var  Regs  :  Registers;  {  Register  variable  for  the  interrupt  } 


begin 

Regs. ah  :=  2; 
Regs.bh  :=  Page; 
Regs.dh  :=  Line; 
Regs.dl  :=  Column; 
intr($10,  Regs) ; 
end; 


{  Function  number  } 
{  display  page  } 
{  Display  coordinates  } 

{  Call  BlOS-Video-Interrupt  } 


{*  GETCURSORPOS:  senses  the  position  of  the  cursor  in  a  display  *} 
{*  page  and  its  start  and  end  line  *} 
{*  Input  :  see  below  *} 
{*  Output  :  The  variables  listed  below  contain  the  values  after  *} 
{*  the  call  of  the  procedure  *} 
{*  Info  :  the  start  and  end  line  of  the  cursor  is  independent  *} 
{*  of  the  indicated  display  page  *} 


procedure  GetCursorPos  (Page  :  integer; 

var  Column, 

Line, 

Beginline,  { 

Endl  :  Integer) ; 


{  the  display  page  } 
{  Column  of  the  cursor  } 
{  Line  of  the  cursor  } 
Start  line  of  the  cursor  } 
{  End  line  of  the  cursor  } 


var  Regs  :  Registers; 


{  Register  variable  for  the  interrupt  } 


begin 

Regs. ah  :=  3; 

Regs.bh  :=  Page; 
intr($10,  Regs) ; 
Column  :=  Regs.dl; 
Line  :=  Regs.dh; 
Beginline  :=  Regs.ch; 
Endl  :=  Regs. cl; 
end; 


{  Function  number  } 
{  Display  page  } 
{  Call  BlOS-Video-Interrupt  } 
{  Result  of  the  Function  } 
{  read  from  the  Register  } 
{  and  store  in  proper  } 
{  Variables  } 


^ ********************************************************************* j 


{*  SETDISPLAYPAGE:  set  the  display  page  *} 
{*  for  output  on  the  monitor  *} 
{*  Input  :  see  below  *} 
{*  Output  :  none  *} 


^ ★*★**★★★★★★***★*★★★***★★********************************************* j 


procedure  SetDisplayPage (Page  :  integer) ;  {  the  new  display  page  } 

var  Regs  :  Registers;  {  Register  variable  for  the  interrupt  } 
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begin 

Regs. ah  :=  5; 
Regs. a 1  :=  Page; 
intr($10,  Regs) ; 
end; 


Function  number  and  display  page  } 
{  Screen  page  } 
{  Call  BlOS-Video-Interrupt  } 


{*  SCROLLUP:  scrolls  a  display  area  by  one  or  more  *} 
{*  lines  up  or  erases  it  *} 
{*  Input  :  see  below  *} 
{*  Output  :  none  *} 
{*  Info  :  If  Number  0  is  passed,  the  display  area  *} 
{*  is  filled  with  blanks  *} 


^ ************ **★**★*★★*** ************************** ********* **********} 


procedure  ScrollUp (Number, 
COLOR, 
ColumnUL, 
LineUL, 
ColumnLR, 
LineLR  : 


{  Number  of  lines  to  be  scrolled  } 
{  Attribute  for  the  blank  lines  created  } 
{  Column  in  the  upper  left  hand  corner  } 
{  line  in  the  upper  left  corner  } 
{  Column  in  the  lower  right  corner  } 
integer) ; {  line  in  the  lower  right  corner  } 


var  Regs  :  Registers;  {  Register  variable  for  calling  Interrupt  } 


begin 

Regs. ah  :=  6; 

Regs. a 1  :=  Number; 
Regs.bh  :=  COLOR; 
Regs.ch  :=  LineUL; 
Regs. cl  :=  ColumnUL; 
Regs.dh  :=  LineLR; 
Regs.dl  :=  ColumnLR; 
Intr ($10,Regs)  ; 
end; 


{  Function  number  and  number  } 

{  Color  of  empty  line(s)  } 
{  Upper  left  } 
{  coordinates  } 
{  Lower  right  } 
{  coordinates  } 
{  Call  BlOS-Video-Interrupt  } 


^ ************************************************************** *******} 


{*  SCROLLDOWN:  Scrolls  a  display  area  by  one  or  more  *} 
{*  lines  down  or  erases  it  *} 
{*  Input  :  see  below  *} 
{*  Output  :  none  *} 
{*  Info  :  If  Number  0  is  passed,  the  display  area  *} 
{*  is  filled  with  blanks  *} 


^ ******************************************************** *************} 

procedure  ScrollDown (Number,  {  Number  of  lines  to  be  scrolled  } 

COLOR,  {  Attribute  for  the  blank  line(s)  created  } 
ColumnUL,  {  Column  in  the  upper  left  corner  } 

LineUL,  {  line  in  the  upper  left  corner  } 

ColumnLR,  (  Column  in  the  lower  right  corner  } 

LineLR  :  integer) ;  {  Line  in  lower  right  corner  } 


var  Regs  ; 

:  Registers; 

{  Register- Variable  for  call  of  Interrupt 

begin 

Regs. ah 

=  7; 

{  Function  number  and  number 

Regs. a 1 

=  Number; 

Regs.bh 

=  COLOR; 

(  Color  of  blank  line  (s) 

Regs.ch 

=  LineUL; 

{  upper  left 

Regs. cl 

=  ColumnUL; 

{  coordinates 

Regs.dh 

=  LineLR; 

{  Lower  right 

Regs.dl 

=  ColumnLR; 

{  coordinates 

Intr ($10, 
end; 

r  Regs) ; 

{  Call  BIOS-Video- Interrupt 

j ******************************************************** *************} 

{*  GETCHAR:  Read  a  character  including  Attribute  from  an  indicated  *} 

{*  position  in  a  display  page  *} 

{*  Input  :  see  below  *} 

{*  Output  :  see  below  *} 

^ ********************************************************************* j 
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procedure  GetChar (Page, 

Column, 

Line  :  integer; 

var  Character  :  char; 
var  COLOR  :  integer) ; 


{  display  page  accessed  } 
{  Display  Column  } 
{  Display  line  } 
{  the  character  } 
{  its  Attribute  } 


var  Regs  :  Registers; 
CurColumn, 

CurLine, 

CurPage, 

Dummy  :  integer; 


{  Register-Variable  for  the  Interrupt  } 
{  current  display  Column  } 
{  current  display  line  } 
{  current  display  page  } 
stores  Variables  which  are  not  needed  } 


begin 

GetVideoMode  (Dummy,  Dummy,  CurPage) ;  {  sense  current  display  page  } 

GetCursorPos  (CurPage,  CurColumn,  CurLine,  {  Get  cursor  position  } 

Dummy,  Dummy) ;  {  in  the  current  display  page  } 

Set CursorPos  (Page,  Column,  Line);  {  cursor  on  the  position  indicated  } 


Regs. ah  :=  8;  {  Get  Function  number  for  char,  and  Attribute  } 

Regs.bh  :=  Page;  {  display  page  } 

Intr ($10,Regs) ;  {  Invoke  DOS  registers  } 

Character  :=  chr (Regs.al) ;  {  ASCII-Code  of  character  } 

COLOR  :=  Regs. ah;  {  Attribute  of  the  character  } 

SetCursorPos (CurPage,  CurColumn,  CurLine) ;{  Set  cursor  old  position  ) 
end; 

^***★★***★★*★**★*★★*★**★*★*★***★*★*★★*★★*•**★★*★★★★*★*★★*★★*★★★★*★*★**★1 


{*  WRITECHAR:  Writes  a  character  with  indicated  color  to  the  *} 
{*  current  cursor  position  in  the  display  page  *} 
{*  indicated  *} 
{*  Input  :  see  below 

{*  Output  :  none  *} 
{*  Info  :  during  the  Output  of  characters,  the  control  codes  *} 
{*  such  as  Carriage-Return  are  treated  as  ASCII  codes  *} 


I **★***★★**★*★** ★***★********★***★★*★★****★**★****★*** *★★★**★**★****★*} 


procedure  WriteChar (Page  ;  integer;  {  Display  page  for  writing  } 

Character  :  char;  {  ASCII-Code  of  the  character  } 

COLOR  :  integer) ;  {  its  Attribute  } 

var  Regs  :  Registers;  {  Register  variable  for  the  Interrupt  } 

begin 

Regs. ah  :=  9; 

Regs.al  :=  ord (Character) ;  {  Function  number  and  character  code  } 

Regs.bh  :=  Page;  {  Display  page  } 

Regs.bl  :=  COLOR;  {  Display  color  } 

Regs.cx  :=  1;  {  output  character  only  once  } 

Intr ($10, Regs) ;  {  Call  BlOS-Video-Interrupt  } 

end; 


^ *★*★*★*★**★*★*****★*★**★*★**★***★★**★*★★*★***★★**★**★*★**★****★*★★*★* j 

{*  WRITETEXT:  Writes  a  String  starting  at  an  indicated  position  in  *} 


{*  a  display  page.  *} 
{*  Input  :  see  below  *} 
{*  Output  :  none  *} 
{*  Info  :  During  output  of  characters  the  control  characters  *} 
{*  such  as  Carriage-Return  are  treated  as  such.  *} 
{*  If  writing  continues  beyond  the  End  of  the  display,  *} 
{*  will  be  scrolled  up  one  line  *} 


I **★★**★*★**★*★★*★**★*★★*★**★★★**★*★★*★*★★* ★**★*★★*★**★*★**★*★★*★**★*★} 


procedure  WriteText (Page,  {  Display  page  for  output  } 

Column,  {  Column,  from  which  output  starts  } 

Line,  {  Line,  from  which  output  starts  } 

COLOR  :  integer;  {  Color  for  all  characters  } 

Text  ;  TextTyp) ;  {  Text  for  output  } 


var  Regs  :  Registers; 


{  Register  variable  for  call  of  Interrupt  ) 
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Counter  :  integer; 


{  Loop  Counter  } 


begin 

SetCursorPos  (Page,  Column,  Line) ; 

for  Counter  :*  1  to  length (Text)  do 
begin 

Writ eChar (Page,  '  ',  COLOR); 

Regs. ah  ;=  14; 

Regs.al  ord (Text [Counter] ) ; 
Regs.bh  :=  Page; 

Intr ($10, Regs) ; 
end; 
end; 


{  Set  cursor  } 

{  process  characters  } 
{  in  sequence  } 
{  Color  at  the  current  position  } 

{  Function  number  and  character  } 
{  Display  page  } 
{  Call  BlOS-Vldeo-Interrupt  } 


^*** ★★***★★***★****★***★****★***★****★***★****★***★★***★***★★***★ ***★*} 
{**  MAIN  PROGRAM  **) 

^ ****************************************** **********★****************} 


begin 
clrscr; 

for  1  :=  1  to  24  do 
for  j  :=  0  to  79  do 
begin 

SetCursorPos (0,  j,  1); 

WriteChar(0,  chr(i*80+j  and  255),  NORMAL); 
end; 

ScrollDown(0,  NORMAL,  5,  8,  19,  22); 

WrlteText(0,  5,  8,  INVERS,  •  Window  1  '); 

ScrollDown(0,  NORMAL,  60,  2,  74,  16); 

WriteText(0,  60,  2,  INVERS,  •  Window  2  •); 

WriteText(0,  24,  12,  INVERS, or  BLINK,  •  »>  PC  SYSTEM  PROGRAMMING  «<  '); 
WriteText(0,  0,  0,  INVERS,  •  Still  have  to  draw  '+ 

'  arrows  on  the  screen  ' ) ; 

for  i  :=  49  downto  0  do  {  draw  a  total  of  50  Arrows  } 

begin 

str(i:2,  IString) ;  (  convert  i  in  ASCII-String  } 

WriteText(0,  37,  0,  INVERS,  IString); 

j  :=  1;  {  every  Arrow  consists  of  16  lines  } 

while  j  <=  15  do 
begin 


{  Erase  display  } 
{  Perform  line  1  to  24  } 
{  do  all  Columns  } 

{  position  cursor  } 
{  Write  a  character  } 

{  Erase  Window  1  } 

{  Erase  Window  2  } 


k  :=  0; 

while  k  <  j  do  {  create  a  line  of  the  Arrow  } 

begin 

SetCursorPos  (0,  12- (j  shr  1) +)c,  9);  (  Arrow  Window  1  } 

WriteChar (0,  ' * ' ,  BOLD) ; 

SetCursorPos  (0,  67- (j  shr  1) +)c,  16);  (  Arrow  Window  2  } 

WriteChar (0,  ' * ' ,  BOLD) ; 
k  :=  succ(k); 


end; 

ScrollDownd,  NORMAL,  5,  9,  19,  22); 
ScrollUpd,  NORMAL,  60,  3,  74,  16); 
for  1  :=  0  to  8000  do 


{  scroll  Window  1  } 
{  scroll  Window  2  } 
{  Wait  Loop  } 


j':=  j+2; 
end; 
end; 
clrscr; 
end. 


{  Erase  display  } 
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C  listing:  VIDEOC.C 


/*  V  I  D  E  0  C  */ 


/* - - - */ 

/*  Task  ;  makes  functions  available  which  are  not  */ 

/*  available  from  the  Library  of  MICROSOFT  and  */ 

/*  the  TURBO  C-Compilers  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  developed  on  :  08/13/87  */ 

/*  last  Update  :  05/14/89  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  MSC  VIDEOC;  */ 

/*  LINK  VIDEOC;  */ 

/*  Call  :  VIDEOC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  through  the  RUN  command  on  the  menu  bar  */ 


♦include  <dos.h>  /*  Include  Header-Files  */ 

♦include  <lo.h> 


♦define  NORMAL 
♦define  BOLD 
♦define  INVERS 
♦define  UNDERLINE 
♦define  BLINK 


0x07  /*  Definition  of  the  character  Attribute  */ 

OxOF  /*  in  relation  to  a  monochrome  */ 

0x70  /*  Display  card  */ 

0x01 
0x80 


/*★★★★*★**★★★*★**★★★*★**★***★**★***************★★★**★**★★★*★**★★★*★***/ 
/*  GETVIDECMODE :  Read  current  Video  mode  and  Parameters  */ 

/*  Input  :  none  */ 

/*  Output  :  see  below  */ 

/★*★★★*★★*★★★**★**★**★★*★★★*★★*★★**★***★**★***★★*★★*★★*★*★*★★**★★*★★**/ 


void  GetVideoMode (VideoMode,  Number,  Page) 

int  *VideoMode;  /*  the  Number  of  the  Video  mode  */ 

int  *Number;  /*  Number  of  Columns  per  line  */ 

int  *Page;  /*  Number  of  current  display  page  */ 

{ 

union  REGS  Register;  /*  Register  variable  for  Interrupt -Call  */ 

Register. h. ah  =  15;  /*  Function  number  */ 

Int86(0xl0,  &Register,  ^Register) ;  /*  Call  Interrupt  10(h)  */ 

*VideoMode  =  Register .h.al;  /*  Number  of  Video  mode  */ 

♦Number  =  Register. h. ah;  /*  Number  of  Characters  per  line  */ 

♦Page  =  Register. h.bh;  /♦  Number  of  current  display  page  ♦/ 

} 


/♦  SETCURSORTYPE;  defines  the  appearance  of  the  blinking  display  ♦/ 
/♦  cursor  ♦/ 
/♦  Input  :  see  below  ♦/ 
/♦  Output  :  none  ♦/ 
/♦  Info  :  for  a  monochrome  display  card  the  parameters  ♦/ 
/♦  can  be  between  0  and  13.  For  a  color  ♦/ 
/♦  display  card  between  0  and  7  ♦/ 


void  SetCursorType (Beginline,  Endl) 

int  Beginline;  /♦  Beginning  line  of  the  cursor  ♦/ 

int  Endl;  /♦  End  line  of  the  cursor  ♦/ 

{ 

union  REGS  Register;  /♦  Register  variable  for  Interrupt -Call  ♦/ 
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Register. h. ah  *  1; 

Register. h.ch  =  Beginline; 

Register. h. cl  =  Endl; 

int86  (0x10,  &Register,  &Register) ; 

} 


/*  Function  nixnber  */ 
/*  Beginning  line  of  cursor  */ 
/*  End  line  of  cursor  */ 
/*  Call  Interrupt  10  (h)  */ 


/*  SETCURSORPOS;  defines  the  position  of  the  cursor  in  the  indicated  */ 
/*  display  page  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 
/*  Info  :  The  position  of  the  blinking  display  cursor  changes  */ 
/*  only  if  the  call  of  this  function  refers  to  */ 
/*  current  display  page  */ 


/**********************************★**********************************/ 


void  SetCursorPos (Page,  Column,  Line) 

int  Page;  /*  Display  page  where  the  cursor  will  be  set  */ 
int  Column;  /*  new  cursor  Column  */ 
int  Line;  /*  new  cursor  line  */ 


{ 

union  REGS  Register;  /*  Register  variable  for  Interrupt -Call  */ 


Register. h. ah  =  2; 

Register. h.bh  =  Page; 

Register. h.dh  =  Line; 

Register. h.dl  =  Column; 

int86  (0x10,  &Register,  ^Register) ; 

} 


/*  Function  number  */ 
/*  Display  page  */ 
/*  Display  line  */ 
/*  Display  Column  */ 
/*  Call  Interrupt  10 (h)  */ 


/*  GETCURSORPOS:  Get  the  position  of  the  cursor  in  a  certain  */ 
/*  display  page  and  its  start  and  end  line  */ 
/*  Input  :  none  */ 
/*  Output  :  see  below  */ 


void  GetCursorPos (Page, 

int  Page; 

int  *Column; 

int  *Line; 

int  *Beginline; 

int  *Endl; 


Column,  Line,  Beginline,  Endl) 

/*  Number  of  display  page 
/*  Column,  where  the  cursor  is  located 
/*  Line,  where  the  cursor  is  located 
/*  Start  line  of  the  cursor 
/*  End  line  of  the  cursor 


*/ 

*/ 

*/ 

*/ 

*/ 


{ 

union  REGS  Register;  /*  Register  variable  for  Interrupt -Call  */ 


Register. h. ah  =  3; 

Register. h.bh  =  Page; 
int86(0xl0,  ^Register,  ^Register) ; 
♦Column  =  Register. h.dl; 

♦Line  =  Register. h.dh; 

♦Beginline  =  Register. h.ch; 

♦Endl  =  Register. h. cl; 

} 


/♦  Function  number  ♦/ 
/♦  Display  page  ♦/ 
/♦  Call  Interrupt  10  (h)  ♦/ 
/♦  Read  result  of  the  Function  ♦/ 
/♦  from  the  Registers  ♦/ 
/♦  and  assign  to  proper  ♦/ 
/♦  Variables  ♦/ 


/★*******★*******************.***************************************** y 

/♦  SETDISPLAYPAGE:  sets  the  display  Page  which  is  to  be  represented  ♦/ 
/♦  on  the  display  ♦/ 

/♦  Input  :  see  below  ♦/ 

/♦  Output  ;  none  */ 

Z***************************.******************************************/ 

void  SetDisplayPage (Page) 

int  Page;  /*  Number  of  the  new  current  display  page  ♦/ 

{ 

union  REGS  Register;  /*  Register  variable  for  Interrupt  call  ♦/ 
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Register. h. ah  =  5;  /*  Function  number  */ 
Register. h.al  =  Page;  /*  Display  page  */ 
int86(0xl0,  ^Register,  &Register) ;  /*  Call  Interrupt  10(h)  */ 

} 


/★★★*★★★★*★*★★★***★**★*★***************************♦******************/ 


/*  SCROLLUP:  Scrolls  a  display  area  up  one  or  several  */ 
/*  lines  or  erases  it  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 
/*  Info  :  If  0  is  passed  as  number,  the  display  */ 
/*  area  is  filled  with  blanks  */ 


/★*★★★★*★★*★★**★*★*★*★*★★★★★********★***★***★*★**★*★*★*★***★*★*★*****★/ 


void  ScrollUp (Number,  Color,  ColumnUL,  LineUL,  ColumnLR,  LineLR) 
int  Number;  /*  Number  of  lines  to  be  scrolled 

Int  Color;  /*  Color  or  Attribute  for  the  blank  lines 

int  ColumnUL;  /*  Column  in  upper  left  corner  of  the  display  area 
int  LineUL;  /*  Line  in  upper  left  corner  of  the  display  area 

int  ColumnLR;  /*  Column  in  lower  right  corner  of  the  display  area 
int  LineLR;  /*  Line  in  lower  right  corner  of  the  display  area 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


{ 

union  REGS  Register;  /*  Register  variable  for  Interrupt  call  */ 


Register. h. ah  =  6; 

Register. h.al  =  Number; 

Register. h.bh  =  Color; 

Register. h. ch  =  LineUL; 

Register. h. cl  =  ColumnUL; 

Register. h.dh  =  LineLR; 

Register.h.dl  =  ColumnLR; 

lnt86 (0x10,  fiRegister,  &Reglster) ; 

} 


/*  Function  number  */ 
/*  Number  of  lines  */ 
/*  Color  of  blank  line(s)  */ 
/*  Set  Coordinates  of  the  */ 
/*  display  Window  to  be  scrolled  */ 
/*  or  erased  */ 

/*  Call  Interrupt  10(h)  */ 


Z************************************************* *********★***★★★*★*★/ 

/*  SCROLLDOWN;  Scroll  a  display  area  by  one  or  more  */ 

/*  lines  down  or  erase  it  */ 

/*  Input  :  see  below  */ 

/*  Output  :  none  */ 

/*  Info  :  If  0  is  passed  as  number,  the  display  */ 

/*  area  is  filled  with  blanks  */ 

/★***★*★***★*★** ★*★★**********★***★***★*★************★***★*★*******★*★/ 
void  ScrollDown (Number,  Color,  ColumnUL,  LineUL,  ColumnLR,  LineLR) 
int  Number;  /*  Number  of  lines  to  be  scrolled  */ 

int  Color;  /*  Color  or  Attribute  for  the  blank  lines  */ 

int  ColumnUL;  /*  Column  in  upper  left  corner  of  the  display  area  */ 
int  LineUL;  /*  Line  in  upper  left  corner  of  the  display  area  */ 

int  ColumnLR;  /*  Column  in  lower  right  corner  of  the  display  area  */ 
int  LineLR;  /*  Line  in  lower  right  corner  of  the  display  area  */ 


{ 

union  REGS  Register;  /*  Register  variable  for  Interrupt  call  */ 


Register. h. ah  =  7; 

Register. h.al  =  Number; 

Register. h.bh  =  Color; 

Register. h.ch  =  LineUL; 

Register. h. cl  =  ColumnUL; 

Register .h.dh  =  LineLR; 

Register.h.dl  *  ColumnLR; 

int86 (0x10,  ^Register,  ^Register) ; 

} 


/*  Function  number  */ 
/*  Number  of  lines  */ 
/*  Color  of  blank  line(s)  */ 
/*  Set  Coordinates  for  the  */ 
/*  display  window  to  be  */ 
/*  scrolled  or  erased  */ 

/*  Call  Interrupt  10  (h)  */ 


/*  GETCHAR:  Read  from  a  designated  display  position  */ 
/*  a  character  and  its  Attribute-Byte  */ 
/*  Input  :  see  below  */ 
/*  Output  ;  see  below  */ 


/***★★ ****************************************************** **********/ 
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void  GetChar (Page,  Column,  Line,  Character,  Color) 

int  Page;  /*  Display  page  from  which  the  character  is  to  be  read 
int  Column;  /*  Display  column  of  the  character 
int  Line;  /*  Display  line  of  the  character 
char  *Character;  /*  the  character  at  this  position 
int  *Color;  /*  its  Attribute-Byte  (Color) 


*/ 

*/ 

*/ 

*/ 

*/ 


( 

union  E^GS  Register; 
int  Dummy; 
int  CurPage; 
int  CurLine; 
int  CurColumn; 


/*  Register  variable  for  Interrupt  call  */ 
/*  for  Variables  which  are  not  required  */ 
/*  the  current  display  page  */ 
/*  the  current  display  line  */ 
/*  the  current  display  Column  */ 


GetVideoMode (&Dummy,  &Dummy,  fiCurPage) ;  /*  Get  current  display  page 
GetCursorPos (fiCurPage,  fiCurColumn,  fiCurLine,  /*  Get  current  cursor 
&Dummy,  &Dummy) ;  /*  position 

SetCursorPos (Page,  Column,  Line) ;  /*  Set  cursor 

Register. h. ah  =  8;  /*  Function  number 

Register. h.bh  =  Page;  /*  display  page 

int86(0xl0,  fiRegister,  &Register) ;  /*  Call  Interrupt  10(h) 

♦Character  =  Register .h.al;  /*  Read  results  from  the  Registers 

♦Color  =  Register. h. ah;  /♦  and  assign 

SetCursorPos (CurPage,  CurColumn,  CurLine) ;/♦  cursor  to  old  position 

} 


♦/ 

♦/ 

♦/ 

♦/ 

♦/ 

♦/ 

♦/ 

♦/ 

♦/ 

♦/ 


/*********************************************************************/ 


/♦  WRITECHAR:  writes  a  character  with  an  Attribute  ♦/ 
/♦  at  the  current  cursor  position  in  the  page  Indicated  ♦/ 
/♦  Input  :  see  below  ♦/ 
/♦  Output  :  none  ♦/ 


/*********************************************************************/ 
void  WriteChar (Page,  Character,  Color) 

int  Page;  /♦  The  character  appears  in  this  display  page  ♦/ 
char  Character;  /*  the  character  to  be  output  ♦/ 
int  Color;  /*  its  Attribute  or  Color  ♦/ 


{ 

union  REGS  Register;  /*  Register  variable  for  Interrupt  call  ♦/ 


Register. h. ah  =  9; 

Register. h.al  =  Character; 

Register. h.bh  =  Page; 

Register. h.bl  =  Color;  /♦ 

Register. x.cx  =  1; 

int86(0xl0,  SRegister,  fiReglster) ; 

} 


/♦  Function  number  ♦/ 
/♦  the  character  to  be  output  ♦/ 
/♦  display  page  ♦/ 
Color  of  character  to  be  output  ♦/ 
/♦  output  character  only  once  ♦/ 
/♦  Call  Interrupt  10  (h)  ♦/ 


/♦  WRITETEXT:  Writes  a  character  string  with  constant  color  ♦/ 
/*  starting  at  a  designated  position  within  a  display  page*/ 
/♦  Input  :  see  below  ♦/ 
/♦  Output  :  none  ♦/ 
/♦  Info  :  Text  is  a  pointer  to  a  character  vector  which  contains  ♦/ 
/*  the  text  to  be  output  and  is  terminated  ♦/ 
/*  with  a  '\0'  character  ♦/ 
/*********************************************************************/ 


void  WriteText (Page, 

int  Page; 

int  Column; 

int  Line; 

int  Color; 

char  ♦Text; 


Column,  Line,  Color,  Text) 

/♦  the  Text  is  output  in  this  display  page 
/♦  display  Column  for  Output 
/♦  display  line  for  Output 
/♦  Color/Attribute  of  the  Text 
/♦  Text  for  output 


♦/ 

♦/ 

♦/ 

♦/ 

♦/ 


{ 

union  E^GS  Register;  /♦  Register  variable  for  Interrupt  call  ♦/ 


SetCursorPos (Page,  Column, 
while  (♦Text) 

{ 


Line) ;  /♦  Set  cursor  ♦/ 

/♦  Output  Text  up  to  '\0'  character  ♦/ 
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WriteChar (Page,  *  ' ,  Color) ; 
Register. h. ah  *  14; 

Register. h.bh  =  Page; 

Register.h.al  -•  *Text++; 
int86(0xl0,  fiRegister,  SRegister); 

} 


/*  Color  for  characters  */ 
/*  Function  number  */ 
/*  display  page  */ 
/*  the  character  for  output  */ 
/*  Call  Interrupt  */ 


/★*****★★★***★★****★★★***★★★★****★★*★**★★★****★★*★****★***************/ 


/*  CLEARSCREEN:  erase  the  80*25  character  Text  display  and  set  */ 
/*  cursor  into  the  upper  left  display  corner  */ 
/*  Input  :  none  */ 
/*  Output  :  none  */ 


/***★*★★***★*★***★**★*****★★**★**★**★***★**★**★★*** ********* **********/ 
void  ClearScreen 0 


{ 

int  CurPage; 
int  Dummy; 


/*  current  display  page  */ 
/*  Dummy  variable  */ 


ScrollUp(0,  NORMAL,  0,  0,  79,  24);  /*  clear  screen  */ 
GetVideoMode  (&Dummy,  &Dummy,  &CurPage) ;  /*  Get  current  display  page  */ 
Set Cur sorPos (CurPage,  0,  0);  /*  Set  cursor  */ 

1 


/*************************★*************************************** *^**/ 
/**  MAIN  PROGRAM  '**/ 

/★********************************************************************/ 
void  mainO 


int  i,  j,  k,  1; 
char  Arrows [3]; 


/*  Loop  variables  */ 
/*  accepts  number  of  Arrows  as  ASCII-String  */ 


/*  Clear  Screen  */ 
/*  process  all  lines  */ 
/*  process  all  Columns  */ 


ClearScreen  0  ; 
for  (i  =  1;  i  <  25;  i++) 
for  (j  *  0;  j  <  80;  j++) 

{ 

SetCursorPos (0,  j,  i); 

WriteChar  (0,  i*80+j&255,  NORMAL); 

} 

ScrollDown(0,  NORMAL,  5,  8,  19,  22); 

WriteText(0,  5,  8,  INVERS,  "  Window  1  "); 

ScrollDown(0,  NORMAL,  60,  2,  74,  16); 

WriteText(0,  60,  2,  INVERS,  ••  Window  2  '•); 

WriteText(0,  24,  12,  INVERS  |  BLINK,  -  »>  PC  SYSTEM  PROGRAMMING  <«  “)  ; 
WriteText(0,  0,  0,  INVERS,  -  There  are  ”) ; 

WriteText(0,  40,  0,  INVERS, "arrows  left  to  draw  ")  ; 

for  (i  *  49;  i  >*  0  ;  i — )  /*  draw  50  Arrows  */ 

{ 

sprintf (Arrows,  "%2d",  i);  /*  Convert  number  of  Arrows  to  ASCII  */ 

WriteText (0,  37,  0,  INVERS,  Arrows);  /*  and  output  */ 

for  (j  =  1;  j  <  16;  j+=  2)  /*  every  Arrow  consists  of  16  lines  */ 


/*  position  cursor  */ 
/*  write  characters  */ 

/*  erase  Window  1  */ 

/*  erase  Window  2  */ 


{ 


for  (k  =  0;  k  <  j;  k++) 

{ 

SetCursorPos  (0,  12-(j»l)+k,  9); 
WriteChar (0,  '*',  BOLD); 
SetCursorPos  (0,  67-(j»l)+k,  16); 
WriteChar (0,  •*',  BOLD) ; 

} 

ScrollDownd,  NORMAL,  5,  9,  19,  22); 
ScrollUp(l,  NORMAL,  60,  3,  74,  16); 
for  (1  =  0;  1  <  4000  ;  1++) 


/*  create  a  line  of  the  Arrow  */ 
/*  Arrow  Window  1  */ 
/*  Arrow  Window  2  */ 


/*  Scroll  Window  1  down  */ 
/*  Scroll  Window  2  up  */ 
/*  Wait  Loop  */ 


} 

} 

ClearScreen () ; 

} 


/*  Clear  Screen  */ 
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7.4.1  The  EGA  and  VGA  BIOS 

The  BIOS  functions  for  screen  output  have  been  part  of  ROM-BIOS  since  the  early 
days  of  the  PC.  Although  they  have  proven  themselves  in  thousands  of 
applications,  they  don’t  work  with  the  newer  types  of  graphic  cards.  EGA  and 
VGA  cards  are  becoming  more  and  more  common  in  the  PC  market. 
Incompatibilities  arise  between  hardware  and  software,  because  these  cards  have 
little  in  common  with  the  CGA  and  MDA  cards  for  which  the  original  BIOS 
functions  were  intended. 

To  make  EGA  and  VGA  cards  compatible  with  programs  that  use  BIOS  functions 
to  do  their  screen  output,  the  BIOS  functions  must  first  be  adapted  to  the  new 
hardware  standards.  The  first  option  would  be  to  replace  the  ROM-BIOS  on  the  PC 
motherboard  with  new  ROMs.  This  solution  can  create  other  problems,  because  no 
set  standard  currently  exists  for  EGA  or  VGA.  Unlike  the  CGA  and  MDA  cards, 
where  the  IBM  standard  took  over  simply  because  there  were  no  other  alternatives, 
EGA  and  VGA  manufacturers  have  yet  to  define  a  universal  standard.  Such  a 
standard  would  have  to  2^ply  to  hardware,  options  and  capabilities  as  offered  by 
each  manufacturer. 

EGA/VGA  ROM-BIOS 

Since  trying  to  adapt  the  ROM-BIOS  included  with  the  computer  to  every  graphic 
card  on  the  market  is  impractical,  the  manufacturers  of  these  systems  use  the 
opposite  approach.  They  package  an  independent  ROM-BIOS  with  their  video 
cards.  There  is  a  small  ROM  on  the  video  card  itself  which  contains  the  necessary 
screen  output  functions.  When  the  system  is  booted,  the  BIOS  detects  this  ROM 
expansion  and  allows  it  to  redirect  the  BIOS  video  interrupt  16H  to  its  own 
routines,  replacing  the  old  functions. 

By  using  these  routines,  all  of  the  programs  which  use  BIOS  functions  for  output 
can  be  executed  without  problems,  but  the  enhanced  capabilities  of  these  video 
cards  are  not  used.  Since  the  ROM-BIOS  on  the  motherboard  is  intended  to  work 
only  with  CGA  and  MDA  cards,  it  supports  only  the  capabilities  of  these  cards. 
So  the  graphic  card  manufacturers  extend  the  BIOS  in  these  video  cards  by 
including  new  functions  or  upgrading  old  functions,  so  that  the  enhanced  video 
capabilities  can  be  used. 

This  section  is  dedicated  to  these  functions.  No  real  standard  exists  for  these  BIOS 
extensions,  as  mentioned  previously.  We  could  use  this  section  to  describe  the 
video  functions  of  the  more  important  EGA  and  VGA  cards  (many  different  cards), 
but  even  with  this  information  you  still  wouldn't  be  able  to  write  programs  which 
would  be  compatible  with  all  of  the  video  cards  on  the  market.  Writing  a  program 
for  a  specific  video  card  makes  sense  only  when  you  want  the  program  to  run  with 
that  card  only. 
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EGA/VGA  video  modes 

Instead,  let's  look  at  the  lowest  common  denominator,  the  video  modes  and 
functions  supported  by  virtually  all  EGAA^GA  cards.  If  you  stick  to  this  "low- 
level"  standard,  you  can  be  fairly  sure  that  your  programs  will  run  properly  with 
all  EGAA^GA  cards.  The  basis  of  this  standard  is  the  set  of  video  modes  supported 
by  the  original  EGA  card,  introduced  by  IBM  in  1985,  or  the  original  VGA  card, 
introduced  by  IBM  in  1987.  All  of  the  manufacturers  of  compatible  cards  have 
included  similar  functions  in  their  own  cards,  and  added  their  own  features. 

All  EGA  and  VGA  cards  have  flexibility  in  common,  which  allows  them  to 
emulate  other  video  cards,  as  well  as  perform  other  tasks.  The  type  of  emulation 
depends  on  the  monitor  connected,  since  unlike  other  cards,  EGAA'^G A  cards  can 
by  used  with  different  types  of  monitors. 

Monitors  and  EGA/VGA 

If  you  connect  a  monochrome  monitor  to  an  EGA  or  a  VGA  card,  it  assumes  the 
features  of  an  MDA  or  Hercules  graphic  card.  If  you  connect  a  color  monitor  to  an 
EGA  or  a  VGA,  it  emulates  a  normal  CGA  card.  However,  EGAA^GA  cards  run 
best  when  connected  to  a  multisync  monitor,  which  allows  color  displays  at  higher 
resolutions  than  Hercules  or  CGA.  The  standard  resolutions  (640x350  for  EGA, 
640x480  for  VGA)  can  be  displayed  on  a  multisync  monitor  with  no  problem. 
However,  multisync  monitors  also  support  the  higher  resolutions  available  on 
many  EGA  and  VGA  cards.  Resolutions  of  800x600  pixels  and  1024x768  pixels, 
are  common.  These  higher  resolutions  can  be  used  only  if  the  EGAA^GA  card  has 
enough  RAM,  since  the  extended  graphics  mode  requires  additional  video  RAM  to 
handle  the  higher  resolutions.  The  programmer  doesn't  have  to  worry  much  about 
this,  because  almost  all  EGA  cards  come  with  256K  RAM  standard.  Very  few 
EGA  cards  come  with  a  mere  64K  and  must  be  expanded  to  256K.  Most  VGA 
cards  come  equipped  with  256K  of  video  RAM,  as  well  as  a  special  VGA  BIOS. 
This  special  BIOS  may  require  special  drivers  to  operate  in  conjunction  with 
graphical  user  interfaces  such  as  GEM®  or  Microsoft  Windows®. 

In  addition,  to  support  the  new  graphic  modes  with  higher  resolutions,  EGA  cards 
offer  a  palette  of  16  colors  chosen  from  the  64  available  colors.  In  text  mode  it  is 
also  possible  to  set  the  heights  of  individual  characters,  so  that  up  to  43  lines  can 
be  displayed  on  the  screen  at  once,  instead  of  the  normal  25  lines. 

VGA  features 

The  VGA  card  is  even  more  powerful.  In  text  mode,  the  VGA  card  can  display  25 
lines,  43  lines  and  even  50  lines  of  text.  In  addition,  the  VGA  has  even  more 
colors  available  (262,144  colors,  as  opposed  to  the  EGA's  64-color  spectrum).  Of 
course,  these  colors  are  only  effective  when  displayed  on  a  monitor  that  has  a  high 
enough  resolution. 
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The  rest  of  this  section  shows  how  these  extended  features  can  be  used  and  how  the 
original  BK)S  functicxis  have  changed. 

As  with  the  normal  BIOS,  all  of  the  video  modes  in  the  EGAA'GA  BIOS  are  set 
with  the  help  of  function  OOH  of  the  BIOS  video  interrupt.  This  function  has  not 
been  chang^  since  the  old  BIOS,  but  it  has  been  extended.  The  number  of  the 
video  mode  to  be  set  is  passed  in  the  AL  register.  The  following  codes  are  allowed: 


1  EGA/VGA  Card  Video  Modes  I 

Code 

Mode  1 

COLOR 

EGA/VGA 

OOH 

■ 

■ 

OlH 

ft  If  PJ3SRFif=i 

■ 

■ 

02H 

80x25  characters,  16  colors 

■ 

■ 

03H 

80x25  characters,  16  colors 

■ 

B 

04H 

■ 

fl 

05H 

320x200  graphic  pixels,  4  colors 

■ 

B 

06H 

640x200  graphic  pixels,  2  colors 

■ 

B 

07H 

■ 

ODH 

320x200  graphic  pixels,  16  colors 

B 

OEH 

640x200  graphic  pixels,  16  colors 

B 

OFH 

640x350  graphic  pixels,  monochrome 

■ 

lOH 

640x350  graphic  pixels, 16  colors** 

B 

IIH 

640x480  graphic  pixels,  2  colors 

B* 

12H 

640x480  graphic  pixels,  16  colors 

B* 

13H 

230x200  graphic  pixels,  256  colors 

B* 

*  VGA  only 

**  EGA  cards  with  64K  of  added  RAM  can  only  display  4  colors 

EGA  and  VGA  cards  can  suppress  clearing  the  video  RAM  when  switching  to  a 
new  video  mode.  If  you  want  to  to  do  this,  bit  7  of  the  AL  register  must  be  set  in 
addition  to  video  mode  number  when  the  function  is  called. 

The  codes  listed  above  are  also  valid  for  the  function  OFH,  which  is  used  to 
determine  the  current  video  mode. 

Nothing  much  has  changed  in  functions  OlH  to  OEH.  Slight  changes  have  been 
made  to  functions  OlH  and  03H,  which  define  and  read  the  design  of  the  cursor.  We 
will  discuss  these  changes  later.  You  can  also  get  exact  descriptions  of  these 
functions  from  the  appendices,  where  all  of  the  functions  of  the  EGAA^GA  BIOS 
are  described. 

Extended  functions 

After  function  OFH,  which  also  appeared  in  the  old  ROM-BIOS,  we  have  three 
new  EGAA^GA  functions  numbered  lOH,  IIH,  and  12H.  These  new  functions  are 
dedicated  to  a  specific  task  and  have  a  number  of  sub-functions. 


256 


Abacus 


7.4  BIOS  Screen  Output  Functions 


Function  10H 

Function  lOH  comprises  all  of  the  sub-functions  for  using  the  color  capabilities  of 
the  EGAA^GA  cards.  Before  we  describe  these  functions,  we  should  first  look  at 
the  way  in  which  the  EGA  and  VGA  cards  create  colors. 

Unlike  the  MDA  and  CGA  cards,  the  two  nibbles  of  the  attribute  byte  of  a 
character  in  text  mode  do  not  directly  specify  the  color  or  attributes  of  the  character 
in  the  EGA.  They  comprise  an  index  to  one  of  the  16  palette  registers  of  the  EGA 
card,  which  then  contains  the  actual  color.  This  makes  it  possible  to  set  the  desired 
colors  individually,  and  allows  color  changes  simply  by  changing  the  contents  of 
the  palette  registers.  The  interpretation  of  the  pdette  register  contents,  and  the 
number  of  displayable  colors,  depend  on  the  type  of  monitor  used.  The  EGA  card 
itself  can  generate  64  colors,  but  these  can  be  dsplayed  only  on  EGA  or  multisync 
monitors,  since  these  monitors  have  the  six  color  lines  required  (2^  =  64).  There 
are  two  lines  available  for  each  fundamental  color  (red,  green,  and  blue),  where  the 
two  lines  control  the  intensity  level  of  the  color.  These  six  lines  correspond 
directly  to  the  lower  six  bits  of  a  palette  register,  as  the  following  figure  shows. 


EGA  palette  registers  when  connected  to  EGA  or  multisync  monitor 

This  color  scheme  is  not  available  when  a  normal  color  monitor  is  connected.  It 
has  only  four  lines  for  the  color  representation,  three  of  which  are  assigned  the 
fundamental  colors  red,  green,  and  blue.  The  fourth  line  simply  allows  the 
resulting  color  to  be  displayed  at  higher  intensity.  These  limited  possibilities  affect 
the  structure  of  the  palette  register,  which  clearly  differs  from  the  six-bit  structure 
used  when  an  EGA  or  multisync  monitor  is  connected.  A  total  of  only  16  colors 
can  be  displayed  in  this  mode. 
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EGA  palette  registers  when  connected  to  a  color  monitor 

The  bits  of  a  palette  register  take  on  a  completely  different  meaning  when  the  card 
is  connected  to  a  monochrome  monitor.  In  this  case  the  monitor  cannot  display 
different  colors,  and  can  only  display  bright,  inverse,  and  underlined  characters. 
When  connected  to  such  a  monitor,  the  meanings  of  the  individual  bits  correspond 
to  those  of  the  attribute  byte  of  an  MDA  card,  which  we  examined  earlier  in  this 
chapter. 

DAC  color  table 

The  VGA  card  also  uses  the  most  signiHcant  and  least  significant  nibbles  of  the 
attribute  byte  as  an  index,  pointing  to  one  of  16  palette  registers.  Unlike  the  EGA 
card,  which  only  contains  the  color  code,  this  byte  contains  a  value  between  0  and 
255.  This  number  acts  as  a  reference  to  the  DAC  (digital  analog  convmer)  color 
table.  This  table  allows  the  VGA  card  to  convert  a  digitally  notated  color  code  into 
an  analog  video  signal.  The  DAC  color  table  sees  each  color  code  as  three  six-bit 
values,  with  each  value  representing  the  degree  of  red,  green  and  blue  intensity  in 
the  color. 

As  the  following  figure  shows,  the  color  code  layout  in  some  registers  plays  a  role 
which  also  involves  the  BIOS.  Bit  7  of  each  value  controls  the  grouping  of  the 
different  registers  in  the  DAC  color  table,  thus  controlling  the  mode  control 
register  of  the  video  controller.  If  this  bit  contains  a  0,  the  index  in  the  DAC  color 
table  bases  its  palette  register  on  the  contents  of  bits  0  to  5,  and  the  color  select 
register  on  bits  2  and  3.  The  consequence  is  that  the  DAC  color  table  is  divided 
into  four  groups  of  64  consecutive  registers.  The  value  in  the  palette  register 
represents  the  index  in  this  group,  whereby  the  active  group  itself  selects  the  color 
based  on  the  contents  of  bits  2  and  3  of  the  color  select  register. 

When  bit  7  of  the  mode  control  register  contains  a  1,  the  DAC  color  table  divides 
into  16  groups  of  16  consecutive  registers.  The  index  of  this  table  is  based  on  bits 
0-3  of  the  corresponding  palette  register,  and  bits  0-3  of  the  color  select  register. 
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These  registers  select  the  active  color  group  fitom  within  the  DAC  color  table,  and 
the  contents  of  the  palette  regist^  rqiresent  the  index  of  this  group. 

You  can  use  this  form  of  coding  for  creating  fast  and  easy  color  changes  when 
characters  on  the  screen  must  be  changed  rapidly.  This  involves  storing  different 
groups  in  the  DAC  color  table  which  specify  brighter  or  darker  colors,  and  quickly 
incrementing  the  active  color  grouping  through  the  color  select  register. 


3  OBit 

3  OBit 

1  4 -Bit Attribute  1 

1  4 -Bit Attribute  1 

15  0  Brie 

15  0  Brie 

1  16  Paktte  Registers  | 

1  16  Pslette  Registers  | 

7  4  3  0  Bit  7  ^ 

1  ColarSdectl^^i^^l  |  Psttem  Re^^  •  | 

1 15 1 14  1 13  1 12  1 1 1  1 10  1 09  1 06  1 07  06 1^03 1 02  1 01  1 00  1  Group 

255  0  Eritrv 

1  256  entries  In  | 

17  0  Bit 

17  0  Bit 

1  18 -Bit  Color  Code  | 

1  18 -Bit  Color  Code  | 

7  6 

7  6 

A  4  groups  of 

U  64  entries 

.  16  groups  of 

1  16  entries 

Mode-Control-Register 

Mode-Control-Register 

Color  code  layout  of  the  VGA  card 

To  perfectly  emulate  a  CGA  or  an  MDA  card,  the  EGA/VGA  BIOS  sets  the 
individual  palette  registers  (or  in  the  case  of  the  VGA  card,  the  DAC  color 
registers)  to  the  same  color  scheme  used  by  a  CGA  or  an  MDA  card  when  the 
corresponding  mode  is  initialized.  In  the  case  of  CGA  emulation  (EGAJWGA  card 
and  a  CGA  monitor),  this  means  that  palette  register  0  contains  the  value  0, 
palette  register  1  the  value  1,  etc.  At  the  same  time,  the  color  select  register  of  the 
VGA  card  must  be  set  to  the  first  of  16  palettes  whose  color  codes  correspond  to 
those  of  a  CGA  card.  This  also  applies  to  CGA  modes  4  and  5  (320x200  pixels, 
four  colors),  which  work  with  one  of  two  color  palettes  which  can  be  selected  via 
function  OBH,  sub-function  1.  The  EGA  BIOS  simply  loads  the  corresponding 
colcn-s  into  the  lower  three  palette  registers,  depending  on  the  palette  selected. 

There  is  normally  no  need  to  change  the  contents  of  the  palette  registers  in  this 
case,  since  no  new  colors  can  be  displayed  on  the  screen.  Individual  colors  can 
easily  be  exchanged  with  each  other. 

Things  are  different  when  an  EGAA^GA  or  multisync  monitor  is  connected.  The 
EGA/VGA  BIOS  loads  values  0  to  15  into  the  16  color  registers  when  the  text 
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mode  is  initialized,  but  this  does  not  exhaust  the  color  options  of  the  EGA  card. 
To  make  full  use  of  these  options,  sub-function  OOH  of  function  lOH  can  be  used 
to  load  one  of  the  16  palette  registers.  In  addition  to  the  function  number  in  the 
AH  register  and  the  sub-function  number  in  AL,  this  function  must  also  be  passed 
the  number  of  the  palette  (0  to  15)  in  BH  and  the  new  color  value  for  this  palette 
in  the  BL  register.  Since  this  function  does  not  check  the  nunriber  of  the  register,  it 
can  also  be  used  to  change  the  contents  of  a  17th  palette  register  (screen  border  and 
background  color  in  the  graphics  mode),  although  it  is  better  to  use  sub-function 
OlH  of  function  lOH  for  this.  Besides,  it  doesn’t  make  much  sense  to  set  a 
background  color  in  the  text  modes,  because  the  text  display  takes  up  almost  the 
entire  screen  with  only  two  or  three  raster  lines  left  over  for  the  output  of  a  border 
color.  The  contents  of  this  palette  register  are  ignored  when  a  monochrome 
monitor  is  connected. 

To  call  the  function  for  accessing  this  palette  register,  the  AH  register  must  first 
be  loaded  with  the  function  number  lOH  and  the  AL  register  with  the  sub-function 
number  OlH.  The  BH  register  holds  the  border  color,  which  is  then  loaded  into 
palette  register  16  when  the  function  is  called. 

Sub-function  02H  of  function  lOH  is  used  when  you  want  to  load  all  of  the  palette 
registers  at  the  same  time,  including  the  register  for  the  border  color.  In  addition  to 
the  function  and  sub-function  numbers  in  AH  and  AL,  respectively,  the  address  of 
a  t^le  must  be  passed  in  the  £S:DX  register  pair.  This  table  contains  the  values 
for  the  17  palette  registers.  When  this  function  is  executed,  the  contents  of  this 
table  will  be  copied  into  the  17  palette  registers  and  will  cause  all  of  the  colors  on 
the  screen  to  change  at  once. 

The  last  sub-function  of  function  lOH  (for  EGA  only)  defines  the  meaning  of  a  bit 
in  the  text  modes.  As  with  the  CGA  and  MDA  cards,  this  bit  can  also  be  used  on 
the  EGA  card  to  emphasize  a  character  by  either  displaying  it  on  a  bright 
background  color  or  flashing  it,  if  the  bit  is  set.  While  the  meaning  of  this  bit  can 
be  changed  only  by  directly  programming  the  video  hardware  with  CGA  or  MDA 
cards,  the  EGAA^GA  BIOS  can  perform  the  same  task  using  sub-function  03H  of 
function  lOH. 

As  with  calling  the  other  sub-functions,  the  function  and  sub-function  numbers 
must  be  passed  in  registers  AH  and  AL.  The  meaning  of  bit  seven  of  the  attribute 
byte  is  determined  by  the  contents  of  the  BL  register.  The  value  of  zero  in  this 
register  sets  the  bright  background  color,  while  the  value  one  causes  all  characters 
on  the  screen,  with  bit  seven  of  their  attribute  bytes  set,  to  flash  on  and  off. 

The  VGA  card  has  additional  functions  available  for  accessing  this  table.  These 
functions  are  all  sub-functions  of  function  lOH,  and  are  only  accessible  from  the 
VGA  card. 

The  contents  of  a  single  DAC  color  register  can  be  modified  using  sub-function 
lOH.  Load  the  AL  register  with  the  sub-function  number,  the  BX  register  with  the 
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number  of  the  corresponding  register  (0-255)  and  the  CH,  CL  and  DH  registers 
with  the  color  code.  Then  call  the  function.  To  help  correctly  interpret  the  contents 
of  this  register,  the  DAC  color  table  must  be  coded  as  an  18-bit  value  (6  bits  for 
red,  6  bits  for  green  and  6  bits  for  blue).  The  red  components  must  be  loaded  into 
the  DH  register,  the  green  components  into  the  CH  register,  and  the  blue 
components  into  the  DL  register. 

You  must  load  the  number  of  the  register  to  be  updated  into  the  BX  register.  The 
registers  receive  the  number  of  the  DAC  register  to  be  updated  when  you  call  sub¬ 
function  15H. 

Any  number  of  DAC  color  registers  can  be  loaded  at  a  time  using  sub-function 
12H.  The  number  of  the  first  DAC  color  register  to  be  loaded  is  passed  to  the  BX 
register,  and  the  number  of  DAC  color  registers  to  be  loaded  is  passed  to  the  CX 
register.  The  new  contents  of  the  DAC  color  registers  are  loaded  into  a  buffer  (the 
address  of  this  buffer  is  contained  in  the  ES:DX  register  pair).  Each  DAC  color 
register  receives  three  consecutive  bytes  from  this  buffer.  These  three  bytes  specify 
the  green  components,  the  red  components  and  the  blue  components  of  the  color 
code. 

Reading  the  DAC  color  table 

Sub-function  17H  reads  the  contents  of  a  group  of  DAC  color  registers.  The 
number  of  the  first  DAC  color  register  to  be  read  is  passed  to  the  BX  register,  and 
the  number  of  registers  is  passed  to  the  CX  register.  The  contents  of  this  register 
copies  the  VGA  BIOS  to  a  buffer,  whose  segment  and  offset  address  may  be  found 
in  the  ES.DX  register  pair.  The  structure  is  identical  to  that  of  sub-function  12H. 
Remember  that  the  registers  for  each  DAC  color  register  consist  of  three  bytes  (not 
one),  and  to  allocate  a  buffer  of  appropriate  size. 

Organizing  the  DAC  color  table 

Sub-function  13H  allows  the  organization  of  the  DAC  color  table  and  the  active 
color  group,  offering  two  of  its  own  sub-functions.  If  the  BL  register  contains  the 
value  0,  then  the  sub-function  copies  bit  0  of  the  BH  register  into  bit  7  of  the 
mode  control  register  of  the  VGA  controller.  The  organization  of  the  DAC  color 
table  can  then  be  broken  down  into  4  or  16  groups.  However,  if  the  BL  register 
contains  the  value  1  when  this  sub-function  is  called,  then  the  sub-function  copies 
the  contents  of  the  BH  register  into  the  color  select  register,  then  selects  the  active 
color  group. 

The  contents  of  both  registers  can  be  conveyed  by  calling  sub-function  lAH.  After 
calling  this  function,  the  content  of  bit  7  of  the  mode  control  register  is  passed  to 
the  BL  register,  and  the  contents  of  the  color  select  register  is  passed  to  the  BH 
register. 
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Gray  scales 

Sub-function  OBH  converts  the  color  codes  within  the  DAC  color  table  into  gray 
scales.  Pass  the  number  of  the  first  register  to  be  converted  into  the  BX  register, 
and  the  number  of  registers  to  be  convated  to  the  CX  register.  The  conversion 
results  in  a  color  value  between  0  (black)  and  1  (white),  based  on  a  red  intensity  of 
30%,  a  green  intensity  of  59%  and  a  blue  intensity  of  1 1%. 

Palette  registers 

The  VGA  BIOS  still  has  more  sub-functions  in  function  lOH  for  reading  the 
palette  legists.  Sub-function  07H  reads  the  contents  of  any  palette  register.  When 
the  function  is  passed  and  the  number  of  the  palette  register  is  passed  to  the  BL 
register,  the  number  of  the  contents  is  returned  in  the  BH  register.  This  allows  read 
access  to  the  contents  of  the  overscan  register  (the  color  border  on  palette  register 
16),  but  this  access  requires  the  use  of  sub-function  OSH.  Like  sub-function  07H, 
the  result  is  loaded  into  the  BH  register. 

Sub-function  09H  loads  the  contents  of  the  entire  palette  table  (i.e.,  all  16  palette 
registers  and  the  overscan  registers)  into  a  17-byte  buffer.  The  segment  address  of 
this  buffer  is  loaded  into  the  £S  register,  and  the  offset  address  is  loaded  into  the 
DX  register. 

Another  feature  of  the  EGA  and  VGA  cards  are  their  ability  to  work  with  a  number 
of  different  fonts  and  font  sizes.  This  feature  allows  the  EGAA^GA  cards  to  be  used 
with  different  monitors,  in  different  resolutions.  Since  the  screen  resolution  is 
determined  by  the  monitor  hardware  and  cannot  be  changed,  the  video  card  must 
adapt  to  the  monitor's  resolution.  Exceptions  to  the  rule  are  the  more  versatile  and 
expensive  multisync  monitors,  which  get  their  name  from  the  ability  to  adapt 
themselves  to  diffident  synchronizations  (resolutions). 

Of  the  different  monitors  which  can  be  used  in  connection  with  an  EGA  or  a  VGA 
card,  the  color  monitor,  normally  used  in  conjunction  with  a  CGA  card,  has  the 
poorest  resolution.  It  only  has  a  resolution  of  640  pixels  (horizontal  direction)  by 
2(X)  pixels  (vertical  direction).  If  you  want  to  display  25  lines  of  80  columns  each 
on  the  screen,  you  will  have  to  use  a  character  matrix  of  8  by  8  pixels  so  that  all 
of  the  characters  fit  on  the  screen. 

Even  though  the  monochrome  monitor  cannot  display  different  colors,  it  does  offer 
a  resolution  of  720  by  350  pixels  when  used  with  an  MDA  or  Hercules  graphics 
card.  The  individual  characters  are  displayed  with  a  matrix  of  9  by  14  pixels. 

EGA  and  multisync  monitors  also  have  a  vertical  resolution  of  350  pixels,  but  can 
only  display  640  pixels  horizontally.  The  resolution  of  individual  characters  is  8  x 
14  pixels — only  slightly  less  than  that  of  the  monochrome  monitors.  VGA  cards 
and  multisync  monitors  usually  support  a  minimum  vertical  resolution  of  480 
pixels,  but  some  units  even  support  600  raster  lines.  VGA  cards  often  permit 
character  matrices  of  8x16  (text  mode)  and  9x16  pixels. 
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Character  generators 

In  order  to  support  the  various  resolutions,  the  EGAA^GA  cards  have  their  own 
character  generators  which  can  display  characters  in  any  height  between  one  and  32 
raster  lines.  The  number  of  text  lines  per  screen  depends  on  the  height  of  the 
displayed  characters  and  the  resolution  of  the  monitor.  To  make  the  best  use  of  this 
feature,  the  EGAA^G A  cards  get  the  bit  patterns  of  the  characters  from  a  section  of 
the  video  RAM  instead  of  from  ROM. 

Function  11 H 

Normally  the  character  generator  is  programmed  autcnnatically  and  the  appropriate 
character  set  is  loaded  when  a  video  mode  is  initialized,  but  it  is  possible  for  a 
program  to  control  these  features  with  function  IIH.  You  might  want  to  use  this 
to  display  more  than  the  usual  25  text  lines  on  a  monochrome,  EGA,  or  multisync 
monitor.  But  even  if  you  do  want  to  use  25  lines,  these  functions  offer  the  ability 
to  redefine  individual  characters  of  the  character  set  or  to  install  an  entirely  new 
character  set.  This  can  be  done  with  sub-function  OOH.  Like  all  of  the  sub¬ 
functions  of  function  IIH,  the  value  IIH  must  be  passed  in  the  AH  register  and 
the  sub-function  number  must  be  passed  in  the  AL  register.  A  number  of  other 
parameters  must  also  be  passed  in  the  other  processor  registers.  The  BH  register 
stores  the  height  of  the  individual  characters.  Since  this  function  is  intended  for 
modifying  individual  characters  of  the  current  character  set,  you  must  load  the 
height  of  these  characters  here.  As  mentioned  above,  the  height  of  characters  on 
monochrome,  EGA,  or  multisync  monitors  is  normally  14  lines  (or  with  the  VGA 
card,  16  lines  on  a  VGA  or  multisync  monitor),  while  on  color  monitors  it  is  8 
lines.  The  BL  register  stores  the  number  of  the  character  table  in  which  the 
character  will  be  loaded.  Theoretically  a  number  0  through  3  can  be  given  here  for 
one  of  the  four  different  character  tables,  but  you  should  restrict  yourself  to 
modifying  character  table  0,  because  it  is  the  only  table  guaranteed  to  be  accessible 
by  EGA  cards  with  less  than  256K  RAM.  This  character  table  is  also  the  one  into 
which  the  EGA  BIOS  loads  the  character  definitions  when  the  video  mode  is 
initialized  with  function  OOH.  Since  you  may  not  want  to  redefine  the  entire 
character  set,  the  CX  register  holds  the  number  of  characters  to  be  defined 
(maximum  of  256).  The  number  of  the  first  character  to  be  defined  is  placed  in  the 
DX  register  and  may  not  exceed  the  value  255. 

The  character  definitions  themselves  are  stored  in  a  buffer  whose  address  is  passed 
in  the  ES:BP  register  pair.  The  bit  patterns  of  the  individual  characters  are  placed 
in  this  buffer  such  that  the  height  of  each  character  (BH  register)  also  specifies  the 
number  of  bytes  per  character  in  the  buffer. 

The  individual  characters  are  stored  sequentially,  so  the  total  size  of  the  buffer  is 
the  number  of  characters  multiplied  by  the  height  of  the  characters.  The  eight  bits 
of  each  byte  reflect  the  status  of  the  individual  pixels  in  each  raster  line.  If  a  bit  is 
set,  the  pixel  will  appear  at  the  corresponding  position  in  the  foreground  color.  If 
the  bit  is  cleared,  the  pixel  will  appear  in  the  background  color.  Note  that  the 
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character  matrix  is  actually  eight  pixels  wide,  even  through  the  characters  are 
displayed  with  a  width  of  nine  pixels  on  a  monochrome  screen.  In  this  case  the 
ninth  bit  is  not  taken  from  the  character  deHnition,  the  last  bit  on  each  line  is 
simply  duplicated. 


Bit  76543210 


ES:BP  — ► 
Line  1 

■ 

■ 

□ 

□ 

□ 

■ 

■ 

■ 

2 

■ 

■ 

□ 

□ 

□ 

■ 

■ 

■ 

3 

■ 

■ 

■ 

□ 

■ 

■ 

■ 

■ 

4 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

5 

■ 

■ 

■ 

□ 

■ 

■ 

■ 

■ 

6 

■ 

■ 

□ 

r 

□ 

■ 

■ 

■ 

7 

□ 

■ 

■ 

■ 

□ 

■ 

■ 

8 

Line  1 

2 

First  character 
00111000b 

00111000b 

00010000b 

11111110b 

00010000b 

00101000b 

01000100b 

00000000b 
Second  character 


Buffer  structure  after  calling  function  IIH,  sub  function  OOH 

As  long  as  characters  with  the  appropriate  ASCII  codes  are  displayed  on  the  screen, 
the  changes  will  be  noticeable  immediately  after  this  function  is  called. 

While  sub-function  OOH  cian  be  used  to  load  user-defined  characters  into  the 
character  set,  sub-functions  OlH  and  02H  are  used  to  load  the  two  ROM  character 
sets  contained  on  the  EGAA^GA  card.  Sub-function  OlH  loads  the  entire  8x14 
character  set  of  the  EGAA^GA  card  into  one  of  the  four  character  tables.  Sub¬ 
function  02H  loads  the  8x8  CGA-compatible  character  set  into  one  of  the  four 
character  tables.  In  addition  to  the  function  and  sub-function  numbers,  both 
functions  are  passed  the  number  of  the  character  table  in  which  the  character  set  is 
to  be  loaded  in  the  BL  register.  If  the  character  table  involved  is  the  one  currently 
displayed  on  the  screen,  then  the  changes  will  be  visible  immediately  after  the 
function  is  called.  Although  these  two  functions  load  the  character  sets,  they  do 
not  set  the  character  generator  to  the  height  of  the  appropriate  character  set.  For 
example^if  you  load  the  8x8  character  set  into  the  current  character  table  while  the 
characters  are  being  displayed  in  an  8x14  matrix,  you  will  get  a  rather  strange 
.display.  Raster  lines  one  to  eight  will  have  the  bit-map  of  the  8x8  character  set 
while  lines  nine  to  14  will  have  the  remainder  of  the  8x14  set. 
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If  you  want  to  wwk  with  several  characto'  sets  in  parallel,  it  is  recommended  that 
you  load  the  individual  character  sets  into  their  own  character  tables  and  then 
switch  between  the  tables.  Sub-function  03H  is  used  to  switch  to  a  new  character 
table.  In  addition  to  the  function  and  sub-function  numbers,  it  must  be  passed  the 
numba  of  the  chaiacta  table  to  be  activated  in  the  BL  regista. 

Sub-functions  lOH,  IIH,  and  12H  are  almost  identical  to  sub-functions  OOH,  OlH, 
and  02H.  They  are  also  used  for  loading  character  sets,  but  they  program  the 
character  generator  at  the  same  time.  This  has  the  result  that  the  characters  are 
displayed  with  the  proper  character  height  after  the  function  is  called.  The  number 
of  text  lines  on  the  screen  changes  automatically. 

Function  lOH  is  used  to  load  and  activate  user-defined  character  sets  and  is  called 
exactly  like  function  OOH.  The  numb^  of  text  lines  which  are  displayed  after  the 
call  to  the  function  results  from  the  vertical  resolution  of  the  monitor  divided  by 
the  height  of  the  individual  characters.  If  this  division  is  not  even  and  there  is  a 
remainder,  the  remaining  lines  will  be  divided  equally  between  the  top  and  bottom 
borders  of  the  screen.  Partial  text  lines  are  not  di^layed. 

Sub-functions  IIH  and  12H  load  and  activate  entire  character  sets.  If  the  8x14 
character  set  is  loaded  with  sub-function  IIH  and  a  monochrome,  EGA,  or 
multisync  monitor  is  being  used,  25  lines  (EGA)  or  28  lines  (VGA)  will  be 
displayed  on  the  screen.  If  this  is  done  while  a  color  monitor  is  connected,  which 
has  a  v^cal  resolution  of  only  2(X)  lines,  only  14  lines  will  be  displayed  on  the 
screen. 

These  changes  must  also  be  taken  into  account  when  calling  function  12H,  which 
loads  and  activates  the  8x8  character  set  The  usual  25  lines  will  be  visible  on  a 
color  monitor,  while  on  the  other  monitors  the  screen  will  consist  of  43  text  lines 
(EGA)  or  50  text  lines  (VGA). 

VGA  BIOS  has  an  additional  sub-function.  When  sub-function  14H  is  called,  it 
loads  and  activates  the  8x16  ROM  character  set  Only  25  lines  of  text  will  appear 
on  the  screen. 

Regardless  of  the  number  of  text  lines  which  result  from  calling  one  of  these 
functions,  the  EGA  BIOS  ensures  that  the  traditional  BIOS  functions  fw  screen 
ouq)ut  (function  numbo^  (X)H  to  OFH)  will  still  work  properly.  Even  if  the  screen 
contains  43  lines,  you  can  call  the  functions  for  character  output,  scrolling  the 
screen,  and  access  the  lines  outside  of  the  usual  25-line  bounda^.  However,  you 
should  avoid  using  multiple  screen  pages  and  just  use  page  0,  or  you  may  run  into 
problems  with  the  BIOS  versions  of  various  manufacturers. 

Cursor  emulation 

Certain  EGA  cards  can  have  problems  with  the  mechanism  called  cursor 
emulation.  This  involves  converting  the  starting  and  ending  lines  of  the  cursor 
when  the  height  of  the  character  matrix  is  changed.  For  example,  if  die  character 
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height  decreases  from  14  to  8  lines,  then  the  cursor  will  be  invisible  if  it  was  in 
the  range  of  raster  lines  from  9  to  14.  To  prevent  this,  the  BIOS  converts  the 
starting  and  ending  lines  to  the  new  matrix  height.  This  mechanism  must  be 
disabled  at  the  beginning  of  a  program.  Unfortunately,  no  function  for  doing  this 
exists  in  the  EGA  BIOS;  the  only  way  to  disable  it  is  to  clear  a  flag  in  one  of  the 
BIOS  variables  (bit  0  in  the  byte  at  address  0040:0087).  The  programs  at  the  end 
of  this  section  demonstrate  this  in  practice.  The  VGA  BIOS  does  possess  such  a 
function,  as  well  see  shortly. 

Function  12H 

All  of  the  functions  described  so  far  can  only  be  used  in  conjunction  with  an  EGA 
card  or  a  VGA  card.  To  determine  if  an  EGA/VGA  card  is  installed,  the  EGAA^GA 
BIOS  offers  function  12H,  which  is  not  available  in  the  normal  ROM-BIOS.  It  is 
called  with  the  function  number  in  AH  and  the  value  lOH  in  the  BL  register.  If 
this  value  is  still  in  the  BL  register  after  the  call,  you  can  assume  that  no 
EGA/VGA  card  is  available  and  the  ncxmal  ROM-BIOS  was  called,  which  does  not 
support  this  function.  A  different  value  shows  that  an  EGA  or  a  VGA  card  is 
available.  In  this  case  the  BH,  BL,  and  CL  registers  contain  configuration 
information  about  the  installed  EGAA^GA  card. 

The  value  in  BH  specifies  the  video  mode  that  will  be  activated  after  the  system  is 
booted.  Since  another  mode  may  have  been  enabled  in  the  meantime,  this 
information  is  of  little  use.  The  value  in  the  CL  register,  which  tells  you  what 
kind  of  monitor  the  card  is  driving,  is  much  more  useful.  The  following  values  are 
returned  for  the  individual  monitor  types: 

OBH  monochrome  monitor 

09H  high-resolution  (EGAA^GA  or  multisync)  monitor 

08H  color  monitor 

The  contents  of  the  BL  register  are  also  useful.  They  specify  the  amount  of  RAM 
installed  in  the  EGA  card.  The  following  codes  can  appear: 

0  64K  1  128K 

2  192K  3  256K 

This  distinction  is  important  if  you  want  to  work  with  multiple  character  tables  or 
with  the  high-resolution  graphics  modes  of  the  EGAA^GA  card.  For  example, 
graphics  mode  number  lOH,  which  offers  a  resolution  of  640x350  pixels,  can  be 
used  only  if  the  EGAA^GA  card  has  at  least  128K  of  RAM.  The  number  of 
character  tables  available  also  depends  on  the  size  of  the  RAM.  This  can  be 
determined  by  the  incrementing  by  1  the  number  returned  in  the  BL  register. 
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Function  1AH 

Function  1  AH,  sub-function  OOH  informs  the  user  of  whether  an  EGA  card  or  a 
VGA  card  is  installed.  This  function  is  only  available  to  VGA  cards.  You  must 
pass  the  function  number  to  the  AH  register  and  place  the  value  OOH  in  the  AL 
register.  This  determines  whether  a  VGA  card  is  installed.  If  the  value  OOH 
remains  unchanged,  there  is  no  VGA  card  available,  while  a  returned  value  of  1  AH 
indicates  a  VGA  card.  The  contents  of  the  BL  register  indicate  the  active  video 
mode: 


Code 

Meaning 

OOH 

No  video  card 

OlH 

MDA  card  /  monochrome  monitor 

02H 

CGA  card  /  color  monitor 

03H 

Reserved 

04H 

EGA  card  /  high-res  monitor 

OSH 

EGA  card  /  monochrome  monitor 

0  6H 

Reserved 

07H 

VGA  card  /  analog  monochrome  monitor 

OSH 

VGA  card  /  analog  color  monitor 

Function  12H,  sub-function  20H  can  be  used  to  install  an  alternate  hardcopy 
routine.  This  can  be  used  when  the  screen  is  displaying  more  or  fewer  than  25 
lines.  Since  the  normal  hardcopy  routine  of  the  BIOS  assumes  that  there  are  25 
lines  on  the  screen,  it  always  prints  exactly  25  lines,  which  may  omit  some  lines 
from  the  hardcopy.  The  alternate  hardcopy  of  the  EGAA^GA  BIOS  always  accounts 
for  the  actual  number  of  lines  displayed  on  the  screen,  and  is  therefore  preferable  to 
the  normal  hardcopy  routine.  It  is  installed  by  calling  the  BIOS  video  interrupt 
lOH,  whereby  the  value  12H  is  passed  in  the  AH  register  and  the  value  20H  must 
be  in  the  BL  register. 

The  VGA  BIOS  includes  six  other  sub-functions  of  function  12H,  exclusively  for 
control  of  the  VGA  card.  Sub-function  30H  helps  determine  the  number  of  raster 
lines  available  (not  text  lines)  when  a  VGA  is  operating  with  a  VGA  or  multisync 
monitor.  In  CGA  mode  this  becomes  only  200  lines  instead  of  400.  The  sub¬ 
function  number  must  be  loaded  into  the  BL  register.  The  VGA  BIOS  interprets 
the  number  it  finds  in  the  AL  register  as  the  number  of  raster  lines.  A  value  of  0 
in  the  AL  register  indicates  2(X),  the  value  1  indicates  350  and  the  value  2  indicates 
400  raster  lines. 

Working  in  conjunction  with  color  selection  as  mentioned  above,  so  that  EGA  and 
VGA  cards  can  load  their  palettes  or  DAC  registers,  the  color  spectrum  of  a  CGA 
card  can  be  emulated.  Sub-function  31H  enables  or  disables  this  emulation  in  the 
VGA  card  after  calling  function  OOH  (video  mode  selection).  Calling  this  sub¬ 
function  signaled  by  the  value  0  in  the  AL  register  activates  green  light,  while  a 
value  of  1  tells  the  VGA  BIOS  to  avoid  loading  the  corresponding  register. 
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Automatic  gray  scaling 

Sub-function  33H  specifies  the  status  of  automatic  gray  scale  summing.  This 
summing  instructs  BIOS  accesses  to  the  DAC  color  table  to  automatically  convot 
color  values  into  gray  scales.  The  contents  of  the  AL  register  indicate  this  status: 
A  value  of  0  indicates  conversion  enabled,  while  a  value  of  1  indicates  no 
coivasion. 

Function  12H,  sub-function  34H  controls  the  suppression  of  cursor  emulation.  A 
value  of  0  in  the  AL  register  enables  cursor  emulation,  while  a  value  of  1 
suppresses  this  emulation. 

Function  13H 

We  will  mention  one  last  function  of  the  EGA/VGA  BIOS.  It  is  not  exactly  new, 
since  it  was  already  in  the  AT  ROM-BIOS,  but  it  was  not  in  the  PC  or  XT  BIOS. 
This  is  function  13H,  which  displays  a  string  on  the  screen.  There  are  four 
diffaent  ouq>ut  modes  available,  which  differ  in  how  the  string  is  passed  to  the 
BIOS  and  whetha  or  not  the  cursor  will  be  placed  at  the  end  of  the  string  when  the 
ouq>ut  is  done.  Also,  die  functions  differ  in  whetha  all  the  characters  in  the  string 
will  be  given  a  constant  color  or  provided  with  individual  attributes.  In  the  first 
case,  the  buffer,  the  address  of  which  is  passed  in  the  ES:BP  register  pair,  need 
only  contain  the  ASCII  codes  of  the  characters  to  be  printed.  The  color  for  all  of 
the  characters  is  taken  from  the  BL  register.  In  the  second  case,  the  attribute  byte 
for  each  character  follows  its  ASCII  code  in  the  buffer. 

The  contents  of  the  AL  regist^  detnmine  which  mode  will  be  used: 

0  =  One  color  for  all  of  the  characters.  The  cursor  position  does  not 
change. 

1  =  One  color  fix'  all  of  the  characto^.  The  cursor  will  be  placed  after  the 

last  character  of  the  string. 

2  =  The  buffer  contains  the  individual  attributes.  The  cursor  position  does 

not  change. 

3  =  The  buffer  contains  the  individual  attributes.  The  cursor  will  be 

placed  after  the  last  character  of  the  string. 

The  number  of  the  screen  page  on  which  the  string  is  to  appear  can  be  specified  in 
the  BH  register,  but  this  should  always  be  the  current  page.  Otherwise  problems 
will  arise  with  printing  control  characters  (carriage  return,  linefeed,  etc.).  The  CX 
register  holds  the  length  of  the  string.  This  refers  to  the  numba  of  characters  to  be 
printed  (attributes  must  not  be  counted  in  modes  2  and  3).  The  output  position  is 
passed  to  function  13H  in  regist»s  DH  (line)  and  DL  (column).  And,  finally,  we 
shouldn't  forget  the  function  number  in  the  AH  legisto'. 
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Demonstration  programs 

After  so  many  register  assignments,  function  numbers,  and  the  like,  it  helps  to  be 
able  to  see  some  example  programs  to  put  the  information  into  perspective.  Many 
of  the  functions  we  discussed  are  found  in  the  programs  listed  below.  Not  all  of 
them  are  called  by  the  actual  main  program  but  are  included  to  show  you  how  it’s 
done. 

The  programs  have  two  main  tasks.  First,  they  show  you  how  to  work  with  and 
program  the  color  palettes.  Second,  and  even  more  important,  these  programs 
show  you  what  possibilities  are  offered  by  defining  your  own  character  sets.  Here 
this  is  used  to  display  a  small  graphic  in  text  mode.  This  could  be  used  when  you 
want  to  display  a  personal  or  company  logo  on  the  scipen,  but  the  characters 
needed  are  not  found  in  the  ASCII  character  set.  In  the  example  program,  this  is 
demonstrated  by  displaying  the  text  "PC  Internals  Michael  Tischer"  on  the  screen 
in  large,  fancy  lettering  while  in  text  mode.  This  message  was  first  drawn  with  a 
graphics  program  and  then  converted  to  a.kind  of  virtual  raster.  This  corresponds  in 
density  to  the  character  matrix  8xl4^pixels  in  the  text  mode  when  an  EGA 
monitor  is  connected.  With  the  help  of  this  raster  we  discovered  that  four  rows  of 
30  characters  each,  for  a  total  of  120  characters,  were  required  to  display  this 
graphic  in  text  mode.  The  next  step  was  to  convert  the  bit- map  of  this  graphic  so 
that  it  could  be  loaded  into  one  of  the  character  tables  with  the  help  of  sub-function 
OOH  of  function  1 IH.  Each  eight  consecutive  pixels  were  combined  into  a  byte  and 
then  14  of  these  eight-bit  units  in  a  column  were  combined  together.  The  results 
are  the  initialized  arrays  in  the  program  listing. 

Once  these  data  are  created,  the  most  time-consuming  part  of  the  whole  procedure 
is  done,  since  all  we  have  to  do  is  call  the  appropriate  function  in  order  to  load  the 
characters  into  the  character  table  so  we  are  able  to  display  them  on  the  screen. 
This  proved  to  be  something  of  a  problem  in  C  because  none  of  the  functions  for 
interrupt  calls  allowed  a  value  to  be  assigned  to  the  BP  register,  which  is  where  the 
offset  address  of  the  character  buffer  must  be  passed.  We  had  to  write  a  small 
assembly  language  routine  which  just  loads  the  parameters  passed  to  it  into  the 
required  registers  and  then  calls  the  BIOS  video  intemipL 

Inside  the  example  program  the  bit  patterns  for  the  graphic  are  loaded  into  the 
character  definitions  for  the  ASCII  codes  128  to  248  with  the  help  of  this  function. 
The  new  characters  replace  the  foreign  characters  and  the  border  characters,  but  the 
standard  ASCII  characters  like  letters  and  numbers  are  retained.  You  can  load  the 
bit  patterns  in  other  parts  of  the  character  set  as  well,  if  you  wish. 

I 

One  routine  in  the  program  which  is  not  executed  is  called  SelLine  and  allows  the 
number  of  text  lines  on  the  screen  to  be  set  (25  or  43).  If  you  use  this  function  to 
put  the  screen  in  43  line  mode,  you  first  make  certain  arrangements  regarding 
screen  ouq)ut.  Both  Pascal  and  C  send  their  output  to  the  screen  using  DOS 
functions  when  printf  or  writeln  is  called.  Turbo  Pascal  allows  direct  access  to  the 
video  RAM  under  certain  conditions,  but  this  doesn’t  change  the  problem.  Here  it 
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depends  on  whether  or  not  an  extended  screen  driver  (ANSI.SYS)  is  installed.  If 
such  a  drivCT  is  not  installed,  the  DOS  will  use  BIOS  function  OEH  of  interrupt 
16H,  which  also  handles  screen  scrolling.  Since  this  function  is  part  of  the  EGA 
BIOS,  it  will  prcqt^ly  recognize  that  the  screen  consists  of  43  lines  and  will  not 
scroll  it  until  the  44th  line  is  reached.  Things  are  different  with  most  ANSI.SYS 
drivers,  which  perform  scrolling  themselves.  Since  many  of  them  assume  a  2S-line 
soeen,  they  will  scroll  until  the  26th  line  is  reached  and  the  remaining  lines  will 
be  wasted. 

To  avoid  such  problems,  the  two  output  routines  in  the  example  programs  offer 
the  ability  to  ouQ>ut  strings  directly  to  the  video  RAM  and  avoid  the  DOS 
functions. 

Pascal  listing:  EGAP.PAS 

{$V-}  {  don't  check  length  of  strings  } 


^  ***************** -k -k*  *******************  ******11*1111*11**  J 


{*  E  G  A  P  *} 

{* - *] 

{*  Description  :  demonstrates  the  use  of  the  functions  of  the  *} 

{*  EGA/VGA  BIOS.  *} 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  on  :  08/30/1988  *} 

{*  last  update  :  06/07/1989  *) 

^  ******************************  *it**it*  ***********************  ***********  j 

program  EGAVGAP? 

Uses  Dos,  CRT;  {  bind  in  the  DOS  and  CRT  units  ) 

type  BytePtr  =  ''byte;  {  pointer  to  a  byte  } 

VElb  »  record  {  describes  a  screen  position  as  2  bytes  } 


Character  :  char; 
Attribute  :  byte; 
end; 

VRam  =  array [0. .4000]  of  VelB; 
Strings  =  string [80]; 


{  the  ASCII  code  } 
{  the  attribute  } 

{  describes  the  video  RAM  ) 
{  output  string  for  PrintAt  } 


const  VIDEO 

INT  -  $10; 

LINE25 

=  25; 

LINE43 

=  43; 

MOMO 

=  0; 

COLOR 

“  1; 

EGA 

*  2; 

Font  : 

array (1. .120, 

(  0, 

0,255,  62,  28, 

(  0, 

0,252,  7,  1, 

(  0, 

0,  0,  0,129, 

(  0, 

0,  62,193,128, 

(  0, 

0,  16,144,112, 

(  0, 

0,  0,  0,  0, 

(  0, 

0,  3,  0,  ■  0, 

(  0, 

0,254,248,112, 

(  0, 

0,  0,  0,  0, 

(  0, 

0,  0,  0,  0, 

(  0, 

o 

o 

o 

o 

(  0, 

0,  32,  96,224, 

(  0, 

0,  0,  0,  0, 

(  0, 

0,  0,  0,  0, 

(  0, 

o 

o 

o 

o 

{  BIOS  video  interrupt  } 
{  25  line  screen  } 
{  43  line  screen  } 
{  constants  for  GetMonTyp  } 


1 . .  14 ]  of  byte  » 
28,  28,  28,  28, 
1,  1,  Is  1, 

195,195,199,199, 
128,  0,  0,  0, 
48,  48,  16,  16, 
0,  0,  0,  0, 
0,  0,  0,  0, 
112,112,112,112, 
0,  0,  0,  0, 
0,  0,  0,  0, 
0,  0,  0,  0, 
224,224,224,224, 
0,  0,  0,  0, 
0,  0,  0,  0, 
0,  0,  0,  0, 


( 

28,  28, 
1,  1, 
206,206,] 
0,  0, 
0,  0, 
0,  0, 
0,  0, 
112,112,] 
252,  61, 
248,  6, 

7,  0, 

254,224,2 
1,  6, 
240,  28, 
63,  15, 


Is  7, 
i2,  14, 
0,  0, 
0,  0, 
0,  0, 
0,  0, 


7,  3, 

0,  0, 


6,  7, 

Is  7, 


31), 

{  E  } 

252), 

{  A  } 

14), 

{  c  } 

0), 

{  H  } 

0), 

{  ] 

0), 

{  L  } 

0), 

{  I  } 

112), 

{  N  ] 

28), 

{  E  } 

3), 

{  ) 

128), 

{  c  } 

224), 

{  0  } 

24), 

]  N  } 

7), 

{  T  } 

7), 

{  A  } 
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( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  30, 

39, 

71, 

135, 

128), 

(  I 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,126, 

30, 

15, 

15, 

14), 

{  N 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,124, 

131, 

3, 

If 

l)f 

{  s 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

129, 

131, 

195), 

{ 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

62, 

193, 

128, 

0), 

{  T 

) 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

192, 

224, 

224), 

{  H 

} 

( 

0, 

0, 

248, 

120, 

56, 

56, 

56, 

56, 

56,  56, 

56, 

56, 

56, 

56), 

{  E 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  31, 

48, 

48, 

48, 

48), 

{ 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,196, 

52, 

12, 

4, 

4), 

{  B 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{  I 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{  T 

} 

( 

0, 

0, 

0, 

0, 

0, 

Of 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{ 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{  P 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

Of 

0, 

0, 

0), 

{  A 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{  T 

} 

( 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62,255, 

Of 

0, 

0, 

0), 

{  T 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,128, 

0, 

0, 

0, 

0), 

{  E 

} 

( 

14, 

14, 

14, 

7, 

7, 

3, 

3, 

1, 

0,  0, 

Of 

0, 

0, 

0), 

{  R 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

128, 

128, 

193,  62, 

0, 

0, 

0, 

0), 

{  N 

} 

( 

0, 

0, 

0, 

0, 

16, 

16, 

32, 

64, 

128,  0, 

0, 

0, 

0, 

0), 

{ 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

Of 

0, 

0, 

0), 

{  0 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  3, 

0, 

0, 

0, 

0), 

{  F 

} 

(112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

248,254, 

Of 

0, 

0, 

0), 

{ 

} 

( 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62,255, 

0, 

0, 

0, 

0), 

{  A 

} 

( 

3, 

3, 

3, 

3, 

3, 

3, 

3, 

3, 

7,159, 

0, 

0, 

0, 

0), 

{ 

} 

(128, 

128, 

128, 

128, 

128, 

128, 

128, 

128, 

192,240, 

0, 

0, 

0, 

0), 

{  c 

} 

(224, 

224, 

224, 

224, 

224, 

224, 

96, 

112, 

49,  30, 

0, 

0, 

0, 

0), 

{  H 

} 

( 

56, 

63, 

56, 

56, 

56, 

24, 

92, 

76, 

134,  1, 

Of 

0, 

0, 

0), 

{  A 

} 

( 

7, 

255, 

0, 

0, 

0, 

0, 

1, 

2, 

12,240, 

0, 

0, 

0, 

0), 

{  R 

} 

( 

7, 

7, 

7, 

7, 

7, 

7, 

7, 

7, 

15,  63, 

0, 

0, 

0, 

0), 

{  A 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

128,224, 

0, 

0, 

0, 

0), 

{  c 

} 

( 

14, 

14, 

14, 

14, 

14, 

14, 

14, 

14, 

31,127, 

0, 

0, 

0, 

0), 

{  T 

} 

( 

Ir 

1. 

1/ 

1. 

1, 

If 

1, 

If 

3,207, 

0, 

0, 

0, 

0), 

{  E 

} 

(192, 

192, 

192, 

193, 

193, 

195, 

195, 

193, 

225,248, 

0, 

0, 

0, 

0), 

{  R 

} 

( 

0, 

7, 

120, 

192, 

192, 

128, 

128, 

192, 

195,124, 

0, 

0, 

0, 

0), 

{ 

} 

(224, 

224, 

224, 

224, 

224, 

224, 

224, 

240, 

112,  29, 

0, 

0, 

0, 

0), 

{  I 

} 

( 

56, 

56, 

56, 

56, 

56, 

56, 

56, 

56, 

124,255, 

0, 

0, 

0, 

0), 

{  N 

} 

( 

31, 

31, 

31, 

0, 

0, 

64, 

96, 

96, 

112,  71, 

0, 

0, 

0, 

0), 

( 

} 

( 

0, 

224, 

248, 

252, 

28, 

12, 

4, 

12, 

24,224, 

0, 

0, 

0, 

0), 

{  T 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{  H 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

(  E 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{ 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

(  A 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

Of 

0, 

0, 

0), 

(  s 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

(  c 

} 

( 

0, 

0, 

252, 

60, 

30, 

30, 

30, 

23, 

23,  23, 

19, 

19, 

19, 

17), 

{  I 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

1, 

If  If 

130, 

130, 

130, 

196), 

(  I 

} 

( 

0, 

0, 

126, 

120, 

240, 

240, 

240, 

112, 

112,112, 

112, 

112, 

112, 

112), 

( 

} 

( 

0, 

0, 

28, 

28, 

28, 

0, 

0, 

0, 

0,252, 

60, 

28, 

28, 

28), 

{  c 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  1, 

6, 

12, 

28, 

24), 

(  H 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,240, 

12, 

2, 

7, 

7), 

{  A 

) 

( 

0, 

0, 

63, 

15, 

7, 

7, 

7, 

7, 

7,  7, 

7, 

7, 

7, 

7), 

(  R 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  62, 

65, 

129, 

128, 

0), 

{  A 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

128, 

192, 

192, 

224), 

{  c 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  63, 

64, 

224, 

224, 

224), 

{  T 

) 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

192, 

96, 

112, 

112), 

{  E 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  7, 

24, 

48, 

112, 

96), 

{  R 

) 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,192, 

112, 

24, 

28, 

28), 

{ 

) 

( 

0, 

0, 

252, 

60, 

28, 

28, 

28, 

28, 

28,  28, 

28, 

28, 

28, 

28), 

{  s 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{  E 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

{  T 

} 

( 

0, 

0, 

63, 

56, 

48, 

48, 

32, 

32, 

32,  0, 

0, 

0, 

0, 

0), 

{ 

} 

( 

0, 

0, 

255, 

112, 

112, 

112, 

112, 

112, 

112,112, 

112, 

112, 

112, 

112), 

{  0 

} 

( 

0, 

0, 

225, 

225, 

97, 

32, 

32, 

32, 

32,  15, 

3, 

If 

1, 

l)f 

{  F 

) 

( 

0, 

0, 

192, 

192, 

192, 

0, 

0, 

0, 

0,192, 

193, 

195, 

195, 

195), 

{ 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,252, 

3, 

0, 

0, 

0), 

{  T 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  64, 

65, 

195, 

71, 

70), 

{  H 

} 

( 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,124, 

131, 

0, 

1, 

1), 

{  E 

} 

( 

0, 

0, 

15, 

3, 

1, 

If 

1, 

If 

If  If 

If 

129, 

193, 

193), 

{ 

} 

( 

0, 

0, 

192, 

192, 

192, 

192, 

192, 

192, 

192,207, 

208, 

224, 

224, 

192), 

{  I 

} 
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<  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,128, 

96, 

112, 

48, 

56), 

{  B 

<  0, 

0, 

0, 

0, 

0, 

0, 

0/ 

0/ 

0,  3, 

12, 

24, 

56, 

48), 

(  M 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,224, 

56, 

12, 

14, 

14), 

{  - 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,126, 

30, 

14, 

15, 

15), 

{  P 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  60, 

78, 

142, 

14, 

0), 

(  c 

(  17, 

17, 

16, 

16, 

16, 

16, 

16, 

16, 

48,254, 

0, 

0, 

0, 

0), 

(196, 

196, 

232, 

232, 

232, 

112, 

112, 

80, 

32,  35, 

0, 

0, 

0, 

0), 

(112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

248,254, 

0, 

0, 

0, 

0), 

(  28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62,255, 

0, 

0, 

0, 

0), 

(  56, 

56, 

56, 

56, 

56, 

24, 

28, 

12, 

6,129, 

0, 

0, 

0, 

0), 

(  7, 

0, 

0, 

0, 

0, 

0, 

1, 

2, 

12,240, 

0, 

0, 

0, 

0), 

(  7, 

7, 

7, 

7, 

7, 

'7, 

7, 

7, 

15,  63, 

0, 

0, 

0, 

0), 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

129,231, 

0, 

0, 

0, 

0), 

(224, 

224, 

224, 

224, 

224, 

225, 

225, 

224, 

240,252, 

0, 

0, 

0, 

0), 

(  0, 

3, 

60, 

224, 

224, 

192, 

192, 

224, 

225,  62, 

0, 

0, 

0, 

0), 

(112, 

240, 

112, 

112, 

112, 

112, 

112, 

120, 

184,  14, 

0, 

0, 

0, 

0), 

(224, 

255, 

224, 

224, 

224, 

96, 

112, 

48, 

24,  7, 

0, 

0, 

0, 

0), 

(  28, 

252, 

0, 

0, 

0, 

0, 

4, 

8, 

48,192, 

0, 

0, 

0, 

0), 

(  28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62,255, 

0, 

0, 

0, 

0), 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,128, 

0, 

0, 

0, 

0), 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  0, 

0, 

0, 

0, 

0), 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,  3, 

0, 

0, 

0, 

0), 

(112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

248,254, 

0, 

0, 

0, 

0), 

(  1, 

1, 

1, 

1/ 

1, 

1, 

1, 

1/ 

3,  15, 

0, 

0, 

0, 

0), 

(193, 

193, 

192, 

192, 

192, 

194, 

195, 

195, 

227,250, 

0, 

0, 

0, 

0), 

(240, 

254, 

255, 

15, 

1, 

0, 

0, 

0, 

129^126, 

0, 

0, 

0, 

0), 

(  14, 

14, 

142, 

206, 

206, 

198, 

71, 

195, 

129,  0, 

0, 

0, 

0, 

0), 

(  1, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

131,124, 

0, 

0, 

0, 

0), 

(193, 

1, 

1, 

1/ 

1, 

1. 

65, 

129, 

3,  15, 

0, 

0, 

0, 

0), 

(192, 

192, 

192, 

192, 

192, 

192, 

192, 

192, 

224,249, 

0, 

0, 

0, 

0), 

(  56, 

56, 

56, 

56, 

56, 

56, 

56, 

56, 

124,255, 

0, 

0, 

0, 

0), 

(112, 

127, 

112, 

112, 

112, 

48, 

56, 

24, 

12,  3, 

0, 

0, 

0, 

0), 

(  14, 

254, 

0, 

0, 

0, 

0, 

2, 

4, 

24,224, 

0, 

0, 

0, 

0), 

(  14, 

14, 

14, 

14, 

14, 

14, 

14, 

14, 

31,127, 

0, 

0, 

0, 

0), 

(  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0,192, 

0, 

0, 

0, 

0)); 

VLine 

liVLine), 

{ 

stores  the 

current  ( 

cursor  position 

VCo 1 umn { VCo 1  umn } , 

NumLinaiNumLlne}  :  byte;  {  number  of  screen  lines  } 

Mono  7  :  boolean;  {  TRUE,  if  monochrome  monitor  } 

I ******************************************************* *************** j 


{*  CEmul:  Switches  the  cursor  emulation  of  the  EGA  card  on  or  off.  *} 
{*  Input  :  -  DOIT  =  TRUE  :  Cursor  emulation  on.  *} 
{*  e)  FALSE:  Cursor  emulation  off.  *} 
{*  Output  :  the  current  cursor  column  *} 


I  IT************** *******************************************************  J 


procedure  CEmul (  Dolt  :  boolean  ) ; 

var  VioInfoByte  :  byte  absolute  $0040: $0087; 

begin 

if  Dolt  then 

VioInfoByte  :=  VioInfoByte  or  1 
else 

VioInfoByte  :=  VioInfoByte  and  254 

end; 


{  BIOS  info  byte  } 


{  turn  emulation  on?  } 
{  yes,  set  bit  0  } 
\  {  NO  } 

{  mask  out  bit  0  } 


^★*********************************************************************^ 
{*  GetCS:  Returns  the  current  output  column.  *} 

{*  Input  :  none  *} 

{*  Output  :  the  current  cursor  column  *} 

^ ********************************************************************** j 

function  GetCS  :  byte; 
begin 

GetCS  :=  VColumn;  {  get  column  from  global  variable  } 

end; 
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^ *★*★★★*★*★*★*★★★*★★*★*★*★*★*★★★★*★*★★★★★*★**★★★*★★***★★★*★★***********} 
{*  GetCZ:  Return  the  current  output  line.  *} 

{*  Input  :  none  *} 

{*  Output  :  the  current  output  line  *} 

^**  ********************************************  *ifk  it***  ******1t*-k1t**ifk-k*-k^ 

function  GetCZ  :  byte; 
begin 

GetCZ  :=  VLine;  {  get  line  from  global  variable  } 

end; 

^**********************************************************************^ 


{*  CharDef:  Defines  the  bit  pattern  of  an  individual  character.  *} 

{*  Input  :  -  ASCII  =  ASCII  code  of  the  first  char  to  be  defined  *} 

{*  -  TABLE  =  number  of  the  character  table  (  0  bis  3  ) 

{*  -  MATRIX  =  number  of  lines  in  the  character  matrix  *} 

{*  -  NUMBER  =  number  of  characters  to  be  defined 

{*  -  BUFPTR  «  pointer  to  the  buffer  with  the  character  *} 

{*  Output  :  none  *} 


^****************** ************************************************** **^ 


procedure  CharDef (  Ascii,  Table,  Matrix,  Number  :  byte; 

BufPtr  :  BytePtr  ) ; 

var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 

begin 

Regs. ax  :=  $1100; 

Regs.bh  :=*  Matrix; 

Regs.bl  :=  Table; 

Regs.cx  ;=  Number; 

Regs.dx  :=  Ascii; 

Regs. bp  :=  Of s  (  BufPtr'" 

Regs.es  :=  Seg(  BufPtr'" 
i nt r ( VIDEO_INT ,  Regs ) ; 
end; 

^ *************************** **★*****★***★★★**★*********★****★★★★★★*★*★* j 


{*  GetMonTyp:  Determines  the  type  of  monitor  attached. 

{*  Input  :  none  *} 
{*  Output  :  the  monitor  type:  MOMO  =  monochrome  monitor  *} 
{  COLOR  =  color  monitor  *} 
{*  EGA  »  EGA  or  Multisync  monitor  *} 


I  ********************************************************************** ^ 


{  ftn.  no.:  character  generator,  subftn.  0  } 
{  line  height  of  the  matrix  } 
{  number  of  the  character  table  } 
{  number  of  the  character  to  be  defined  } 
{  first  character  to  be  defined  } 
) ;  {  offset  address  of  the  buffer  } 

);  {segment  address  of  the  buffer  } 

{  call  BIOS  video  interrupt  } 


function  GetMonTyp  :  byte; 

var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 


begin 

Regs. ah  :=  $12; 

Regs.bl  :=  $10; 
intr (VIDEO_INT,  Regs) ; 
case  Regs. cl  of 

$0B  :  GetMonTyp  :=  MOMO; 

$08  :  GetMonTyp  :=  COLOR; 

$09  :  GetMonTyp  :=  EGA; 

end; 
end; 


{  ftn.  no. :  get  configuration  } 
{  subfunction  number  } 
{  call  BIOS  video  interrupt  } 
{  CL  contains  the  monitor  type} 
{  monochrome  monitor  } 
{  color  monitor  } 
{  EGA  monitor  } 


^ ********************************************************************** j 

{*  SetCur  :  Sets  the  blinking  cursor  and  the  internal  output  position  *} 
{*  Input  :  “  COLUMN  =  output  column  (  0  ..  79  )  *} 

{*  -  LINE  =  output  line  (  1  ..  n  )  *} 

{*  Output  :  none  *} 

^ ********************************************************************** j 

procedure  SetCur (  Column,  Line  :  byte  ); 
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var  Regs  :  Registers; 
begin 

Regs. ah  :=  $2; 

Regs.bh  :*  0; 

Regs.dh  :=  Line; 
Regs.dl  :*  Column; 
intr (VIDEO_INT,  Regs); 
VLine  :=  Line; 

VColuran  :*  Column; 
end; 


{  processor  registers  for  interrupt  call  } 


{  ftn.  no.:  set  cursor  position  } 
{  screen  page  0  } 
{  set  coordinate  } 

[  call  BIOS  video  interrupt  } 
{  save  coordinates  in  internal  variables  } 


^ ********************************************************************** j 

{*  SetCol  :  Defines  the  contents  of  one  of  the  16  color  registers  in  *} 


{*  the  EGA  card.  *} 
{*  Input  :  -  REGNR  =  number  of  the  color  register  *} 
{*  -  COLOR  =  color  value  (0  to  63)  *} 
{*  Output  :  none  *} 


I  **★**★ ************************************************************** **j 


procedure  SetCol  (regnr,  color  :  byte) ; 

var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 


begin 

Regs. ah  $10; 

Regs.al  :=  0; 

Regs.bl  :*  regnr; 

Regs.bh  :=  color  and  63;  {  set 

intr (VIDEO_INT,  Regs) ; 
end; 


{  ftn.  no.:  set  colors/attributes  } 
{  subfunction  0  } 
{  set  number  of  the  register  } 
color  value  (mask  out  bits  6  and  7)  } 
{  call  BIOS  video  interrupt  } 


^ ********************************************************************** j 

SetBorder  :  Defines  the  border  color.  *} 

(*  Input  :  -  COLOR  *  color  value  (0  to  63)  *) 

{*  Output  :  none  *} 

^ ******************************************************************* ***j 

procedure  SetBorder (color  :  byte) ; 


var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 

begin 

Regs. ah  :»  $10; 

Regs.al  :=  1; 

Regs.bh  :=  color  and  63; 
intr (VIDEO_INT,  Regs) ; 
end; 

^ ********************************************************************** j 


{*  SetLines  :  Sets  the  number  of  lines.  *} 

{*  Input  :  Sub-function  of  function  IIH:  *} 

$11  :  8x4  character  set  *) 

{*  $12  :  8x8  character  set  *} 

{*  $14  :  8x16  character  set  *} 

{*  Output  :  none  *} 


^*★*★******************************************************************1 


{  ftn.  no.:  set  colors  attributes  } 
{  subfunction  0  } 
{  set  color  value  (mask  out  bits  6  and  7)  } 
{  call  BIOS  video  Interrupt  } 


procedure  SetLines (  Lines  :  byte) ; 


var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 


begin 

Regs. ah  :=  $11; 

Regs.al  :=  Lines; 
Regs.bl  :=  0; 
intr (VIDEO_INT,  Regs) ; 
end; 


ftn.  no.:  character  generator  } 
{  sub-function  of  fnc.  llh  } 
{  use  character  table  0  } 
{  call  BIOS  video  interrupt  } 
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I ***★******★★★*★ *★******★★★***********★****★**★******★*******★**★★ ★****} 


{*  IsEga:  Determines  if  an  EGA  card  is  installed  and  handles  the  *} 
{*  initialization  of  the  global  variables.  *) 
{*  Input  :  none  *} 
{*  Output  :  TRUE,  if  an  EGA  card  is  Installed,  else  FALSE.  *} 


I **★★*★*******★******★★★★ ★★*★★**★*★**********★♦*******************★***★ j 


function  IsEga  :  boolean; 

var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 


begin 

Regs. ah  :=  $12; 

Regs.bl  $10; 
intr (VIDEO_INT,  Regs); 
if  Regs.bl  <>  $10  then 
begin 

{*-  create  pointer  to 
Mono  :*  Regs.bh  -  1; 
IsEga  :=  TRUE; 
end 
else 

IsEga  :=  FALSE; 

end; 


{  ftn.  no.:  get  video  configuration  } 
{  subfunction  number  } 
{  call  BIOS  video  interrupt  } 
{  is  it  an  EGA  or  VGA  card?  } 
{  yes  } 

VRAM  depending  on  the  monitor  connected  -*} 
{  connected  to  monochrome  monitor?  } 
{  an  EGA  card  was  discovered  ) 


{  no  EGA  card  discovered  } 


*****************  ******************* ***************************11******^ 
*  IsVga:  Determines  whether  a  VGA  card  is  installed,  and  initializes  *} 


*  the  global  variables.  *} 

*  Input  :  none  *} 

*  Output  :  TRUE  if  a  VGA  card  is  installed,  otherwise  FALSE.  *} 

*  Info  :  Use  this  function  BEFORE  calling  the  ISEGA  in  your  own  *} 

*  application,  since  the  TRUE  for  some  EGAs  also  applies  *} 

*  to  this  routine  as  well.  *) 


function  IsVga  :  boolean; 


var  Regs  :  Registers;  {  processor  register  for  the  interrupt  call  } 


begin 

Regs. ah  :=  $1A; 

Regs.al  :*  $00; 
intr (VIDEO_INT,  Regs) ; 
if  (  Regs.al  *  $1A  )  and 
begin 

Mono  :=  FALSE; 

IsVga  :=  TRUE; 
end 
else 

IsVga  :=  FALSE; 

end; 


{  function  no,:  Determine  video  system  } 

{  Call  BIOS  video  interrupt  } 
((  Regs.bl  =  7  )  or  (  Regs.bl  *  8  ))  then 

{  VGA  card  Installed  and  active  } 

{  definitely  a  VGA  card  on  board  ) 


{  no  VGA  card  connected  } 


{*  PrintAt:  Outputs  a  string  at  the  give  screen  position  with  a  *} 
{*  certain  attribute.  *} 
{*  Input  :  -  COLUMN  *  output  column  (  0  ..  79  )  *} 
{*  -  LINE  -  output  line  (  0  ..  NUMLINE-1  )  *} 
{*  -  COLOR  »  attribute  for  the  characters  to  be  printed  *} 
{*  -  OUSTR  “  the  string  to  be  printed  *} 
{*  Output  :  none  *} 


procedure  PrintAt (  Column,  Line,  Color  : 
byte;  OutStr  :  stringB); 


var  ColorRAM 
MonoRAM 
Index 
Stren, 
i 


:  VRam  absolute  $B800:0000;  {  describes  physical  VRAM  } 

:  VRam  absolute  $BOOO:0000;  {  describes  physical  VRAM  } 

:  word;  {  index  into  the  VRAM  array  ) 

{  length  of  the  string  to  be  printed  } 
:  byte;  {  running  pointer  to  the  string  } 
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begin 

Stren  :=«  length (  OutStr  ); 

Index  Line  *  80  +  Column; 
if  Mono  then 
begin 

for  i:=l  to  Stren  do 
begin 

MonoRAM[  Index  ] .Character  := 
Mo no RAM [  Index  ] .Attribute  :* 
inc (  Index  ) ; 
end; 


i  get  length  of  the  string  } 
{  set  index  in  the  array  } 

{  yes  } 

{  run  through  the  string  } 

OutStr[i];  {  set  character  } 
Color;  {  set  color  } 

{  increment  the  index  } 


end 

else  {  output  to  the  color  screen  } 

begin 

for  i:=l  to  Stren  do  {  run  through  the  string  } 

begin 

ColorRAM[  Index  ] .Character  :=  OutStr[i];{  set  character  } 
ColorRAM[  Index  ] .Attribute  :*  Color;  {  set  color  } 

inc(  Index  );  {  increment  the  index  } 

end; 


end; 

{* —  calculate  new  cursor  position - *} 

SetCur ( (VColumn  +  VLine  *  80  +  Stren)  mod  80, 

(VColumn  +  VLine  *  80  +  Stren)  div  80) ; 

end; 


I  ********************************************************************** j 


{*  Blinking  :  Defines  the  meaning  of  bit  7  in  the  attribute  of  a  *} 
{*  character  in  the  text  modes.  *} 
{*  Input  :  -  DoBlink  =  TRUE  :  blinking  *} 
i*  FALSE:  intense  background  color  *} 
{*  Output  :  none  *} 


I  ********************************************************************** j 


procedure  Blinking (  DoBlink  :  boolean  ); 


var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 


begin 

Regs. ah  :=  $10; 

Regs.al  :=  $3; 
if  DoBlink  then 
Regs . bl  : =  1 
else 

Regs.bl  :=  0;  {  yes, 

i nt r (VIDEO_INT ,  Regs ) ; 
end; 


{  ftn.  no.:  set  colors/attributes  } 
{  subfunction  number  } 
{  blinking?  } 
{  yes,  BL  =  1  :  blinking  } 
{  no  } 

BL  =  0  :  intense  background  color  } 
{  call  BIOS  video  interrupt  } 


I *************** ******************************************************* j 


{*  Cls:  Clears  the  screen,  causing  the  video  mode  to  be  reset.  *} 
{*  The  palette  registers  will  also  be  filled  with  the  default  *} 
{*  values  and  the  character  set  will  be  reset.  *} 
{*  Input  :  none  *} 
{*  Output  :  none  *} 


I  ********************************************************************** j 

procedure  Cls; 


var  Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 


begin 

Regs. ah  :=  $0; 
if  Mono  then 
Regs.al  :=  7 
else 

Regs.al  :=  3; 
intr (VIDEO_INT,  Regs) ; 
end; 


{  ftn.  no.:  set  video  mode  } 
{  connected  to  monochrome  monitor  } 
{  yes,  80x25  text  display  } 
{  no,  color  monitor  } 
{  yes,  80x25  character  text  display  } 
{  call  BIOS  video  interrupt  } 
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{  ***  it-k  It -k*  itit-k -klt-k  *ifk -k -k*  it -kit'l, -k-k  ********* -k  *** -kit  ******  *********  ^ 

{*  EgaVga  :  Demonstrates  how  to  use  the  functions  of  the  EGA/VGA  BIOS.*} 
{*  Input  :  TRUE  if  VGA  card  installed,  otherwise  FALSE  *} 

{*  Output  :  none  *} 

^**********************************************************************^ 


procedure  EgaVga  (VGA  ;  boolean) ; 


var  1,  j,  )c  :  word; 

Out St r  :  Strings; 
Regs  :  Registers; 


{  loop  counter  } 
{  logo  output  string  } 
{  processor  register  for  the  interrupt  call  } 


{  alternate  select  function  } 
{  sub- function:  install  rtne  } 
{  call  interrupt  } 


begin  > 

{* —  Add  EGA/VGA  hardcopy  routine  *} 

Regs. ah  :=  $12; 

Regs.bl  ;=*  $20; 
intr (VIDEO_INT,Regs) ; 

{* —  prepare  screen  layout  - 

SetCur (0,0) ; 

Cls;  {  clear  the  screen  } 

Blin)cing(  FALSE  );  {  light  bac)cground  instead  of  blln)cing  ) 

if  (  VGA  )  then  {  Chec)c  compatibility  in  case  characters  must  be  } 

begin  {  redefined,  and  the  characters  must  be  changed  } 

Regs. ah  :*  $12;  {  into  350-1  ine  mode  (changed  bac)c  into  EGA  } 

Regs.bl  :=  $30;  {  mode).  } 

Regs.al  :=  1; 

intr (VIDEO_INT,  Regs);  {  call  BIOS  video  interrupt  } 


SetLines(  $11  ); 
end; 


{  activate  8x14  character  set  } 


CharDef(128,  0,  14,  120,  BytePtr (@font) ) ; 


{  define  character  } 


for  i:*=l  to  250  do  {  run  through  the  loop  500  times  } 

begin  {  write  color  bars  to  the  video  RAM  } 

PrlntAt  (GetCs,  GetCZ,  ( (i  mod  14)  +  1)  shl  4,  '  •); 

if  i  <>  250  then  {  last  color  laar?  } 

Print At (GetCs,  GetCZ,  0,  '  •);  {  no  } 

end; 

{  maJce  room  for  logo  } 
•); 

{  first  character  in  logo  } 
{  the  logo  consists  of  4  lines  } 


{  empty  the  string  } 
{  each  line  consists  of  30  characters  } 


for  i:»10  to  15  do 
PrinTat(22,  i,  0,  • 

Ic  128; 
for  1;=0  to  3  do 
begin 

OutStr  "; 
for  j;“l  to  30  do 
begin 

OutStr  ;=  OutStr  +  chr(  Ic  ) ;  {  append  the  char  to  the  string  } 
inc  (  )c  ) ;  {  increment  K  } 

end; 

PrintAt(24,  i+11,  15,  OutStr);  {  output  the  string  } 

end; 

The  most  important  characters  are  ' ) ; 
still  present  in  spite  of  the  logo!  '); 

•); 

!••#$%&••  ()*+-./0123456789:;<->?@  •)  ; 
ABCDEFGHIJKLMNOPQRSTUVXXYZ [\ ] ^_  • ) ; 

'  abcdefghl  jlclmnopqrstuvxyz  { |  }  -  * )  ; 


PrintAtd,  1,  15, 

PrintAtd,  2,  15, 

Prlntatd,  3,  15, 

Printatd,  4,  15, 

Prlntatd,  5,  15, 

Prlntat(l,  6,  15, 

Printat(33,  21,  15 
Prlntat(33,  22,  15 
Prlntat(33,  23,  15 
SetCur (34,  22); 

{* —  change  the  colors  in  the  color  bars - *} 

1  :=  0;  {  start  value  for  the  color  registers  } 

while  (  not  KeyPressed  )  do  {  repeat  until  )cey  is  pressed  } 

begin 

inc (  i  ) ;  {  increment  the  color  value  for  the  first  register  } 

for  j:*l  to  14  do  {  run  through  registers  1  to  14  } 


press  any  key  to  end  the  program. 


•); 

•); 

•); 
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SetCol(j,  i+j  and  63);  {  write  color  value  in  the  register  } 

end; 

if  (  VGA  )  then  {  Switch  VGA  card  back  into  400-line  mode  } 

begin 

Regs. ah  ;»*  $12; 

Regs.bl  $30; 

Regs.al  :»  2; 

Intr (VIDEO_INT,  Regs);  {  call  BIOS  video  interrupt  } 

SetLines(  $14  );  {  activate  8x16  character  set  } 

end; 

Cls;  {  clear  screen  } 

end; 


I ************ ************************************** *4r  ****** ********★***} 

{**  MAIN  PROGRAM  **} 

I  ********************************************************************** ^ 


{ 


{ 


VGA  card  Installed? 
{  YES,  run  demo 


begin 

if  IsVga  then 
EgaVga(  true  ) 
else 
begin 

if  IsEga  then 
begin 

if  (  GetMonTyp  =  EGA  )  then 
EgaVga (  false  ) 
else 
begin 

writeln  ( 'This  program  only  works  with  an  EGA  '); 
writeln ( 'card  or  VGA  card,  and  a  monitor  '); 
writeln ( 'supported  by  one  of  these  cards.  '); 
end; 


EGA  card  installed? 

{  YES 

{  EGA  monitor  attached? 

{  YES,  run  demo 
{  NO,  wrong  monitor 


end 

else 

writeln ( 


end; 

end. 


'No  EGA  or  VGA  card  installed. ..' + 
'  Program  aborted. '  ) ; 


C  listing:  EGAVGAC.C 

/***************************************************************** *****y 


/*  EGAVGAC  */ 

/* - */ 

/*  Task  :  Demonstration  using  the  functions  available  */ 

/*  in  the  EGA-/VGA-BIOS  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  Developed  on  :  08/30/1988  */ 

/*  Last  update  :  05/02/1989  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  CL  /AS  /c  EGAVGAC.C  */ 

/*  LINK  EGAVGAC  EGAVGACA;  */ 

/*  Call  :  EGAC  */ 

/* - - - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  Make  a  project  file  containing  the  following:  */ 

/*  EGAVGAC  */ 

/*  EGAVGACA. OBJ  */ 

/*  Before  compiling,  select  the  Options  menu  */ 

/*  and  the  Compiler  option  -  make  sure  that  the  */ 

/*  Small  model  is  active  */ 

/*  Select  the  Linker  option  -  make  sure  that  the  */ 

/*  Case-sensitive  link  is  set  to  Off  */ 

/*  The  program  will  compile  with  one  warning...  */ 
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/*  this  is  okay,  it  will  run  correctly  */ 

/★*★***★***★*******★★*★★**★★**★***★****★**★***★***★*★*★**★***★***★***★*/ 

/*"  Add  include  files  *==*===*===========*«=«=»====================*/ 

♦include  <dos.h> 

♦include  <stdlib.h> 

♦include  <string.h> 

♦include  <stdarg.h> 

♦include  <bios.h> 

typedef  unsigned  char  BYTE;  /*  Create  a  byte  */ 

typedef  unsigned  int  WORD; 

typedef  BYTE  BOOL;  /*  like  BOOLEAN  in  Pascal  */ 

typedef  struct  velb  far  *  VP;  /*  VP  =  FAR  pointer  to  the  video  RAM  */ 

/*==  Function  definition  from  the  assembler  module  ==««=============*/ 

extern  void  chardef (  BYTE  ascii,  BYTE  table,  BYTE  lines, 

BYTE  amount,  BYTE  far  *  buf  )  ; 


struct  velb  {  /*  Describes  a  two-byte  position  on  the  screen  */ 

BYTE  ascii_code,  /*  ASCII  code  */ 

attribute;  /*  Corresponding  attribute  */ 

}; 


/*==  Macros  =====================================================«==*===**/ 

/* —  MK_FP  creates  a  FAR  pointer  to  an  object  out  of  a - */ 

/* —  segment  address  and  an  offset  address  - */ 


♦ifndef  MK_FP  /*  MK_FP  not  defined  yet?  */ 

♦define  MK_FP (seg,  ofs)  ((void  far  *)  ((unsigned  long)  (seg) «16| (ofs) ) ) 
♦endif 


♦define  VOFS(x,y) 
♦define  VPOS(x,y) 
♦define  GETCZ  () 
♦define  GETCS  () 


(  80  *  (  y  )  +  (  X  )  )  /*  Offsetpos.  in  video  RAM  */ 
(VP)  (  vptr  +  VOFS(  X,  y  )  )  /*  Pointer  in  VRAM  */ 
(vline)  /*  Returns  the  current  cursor  line  */ 
(vcolumn)  /*  Returns  the  current  cursor  column  */ 


♦define  TRUE  (  1  ==  1  )  /*  Constants  for  working  with  BOOL  */ 

♦define  FALSE  (  1  ==  0  ) 

♦define  VIDEO_INT  0x10  /*  BIOS  video  interrupt  */ 

♦define  MONO  0  /*  Monitor  types  for  GETMON  */ 

♦define  COLOR  1 
♦define  EGA  2 

♦define  PAUSE  100 


VP  vptr;  /*  Pointer  to  the  first  character  in  video  RAM  */ 

BYTE  vline,  /*  States  the  current  cursor  position  */ 

vcolumn; 

BOOL  mono;  /*  TRUE  if  a  monochrome  monitor  is  connected  */ 

/****it*ifkififk-kit******-k***-k**i,-k*1iifki(*itit**-kififk**1r****it***it****it******it***** 

*  Function  :  C  E  M  U  L  * 

** - 

*  Task  :  Enables/disables  cursor  emulation  on  the  * 

*  EGA  card.  * 

*  Input  parameters  :  -  DOIT  =>=  TRUE  :  Emulation  on  * 
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*  FALSE:  Emulation  off  * 

*  Return  values  :  None  * 

********************************** -k-k-k**  it  **********************  *********  / 

void  cemul (  BOOL  doit  ) 


{ 

/* —  Definition  of  video  info  byte  at  offset  address  0x87  within  - */ 

/* —  the  BIOS  variable  segment - */ 


idefine  VIO_INFO_BYTE  ((BYTE  far  *)  MK_FP (0x40,  0x87)) 


if  (  doit  ) 
*VIO_INFO_BYTE  |=  1; 
else 

*VIO_INFO_BYTE  &=  254; 


/*  Cursor  «nulation  enabled?  */ 
/*  YES,  set  bit  0  */ 
/*  NO,  */ 
/*  clear  bit  0  */ 

I 


/*********************************************************************** 


*  Function  :  G  E  T  M  0  N  * 

★  * - - 

*  Task  :  Determines  the  type  of  monitor  connected.  * 


*  Input  parameters  :  None 

*  Return  values  :  Monitor  type 

*  MONO  =  monochrome  monitor 

*  COLOR-  Color  monitor 

*  EGA  =  EGA  or  multisync  monitor 

***********************************************************************/ 


BYTE  getmonO 

{ 

union  REGS  regs;  /*  Processor  register  for  interrupt  call  */ 


regs.h.ah  =  0x12;  /*  Function  number:  Determine  configuration  */ 


regs.h.bl  =  0x10; 
int86 (VIDEO_INT,  &regs,  &regs); 
if  (  regs. h. cl  ==  OxOB  ) 
return (  MONO  ); 
if  (  regs. h. cl  ==  0x08  ) 
return (  COLOR  ) ; 
else 

return (  EGA  ) ; 


/*  Sub-function  number  */ 
/*  Call  BIOS  video  interrupt  */ 
/*  Monochrome  monitor?  */ 
/*  YES  */ 
/*  color  monitor?  */ 
/*  YES  */ 
/*  NO,  must  be  EGA  */ 


/*********************************************************************** 


*  Function  :  S  E  T  C  U  R  * 

★  * - \ _ ** 

*  Task  :  Sets  the  screen  cursor  and  the  internal  * 

*  position  of  the  output.  * 


*  Input  parameters  :  -  COLUMN  -  the  cursor  column  * 

*  -  LINE  -the  cursor  line  * 

*  Return  values  :  None  * 

★**★*★****★★**★***********★★*★**★★**★★*★**★****★*******★**★*★★★ **★★****/ 

void  setcur(BYTE  column,  BYTE  line) 

{ 

union  REGS  regs;  /*  Processor  register  for  interrupt  call  */ 

regs.h.ah  =2;  /*  Function  number  */ 

regs.h.bh  -  0;  /*  Use  video  page  zero  */ 

regs.h.dh  -  vline  =  line;  /*  Use  global  variables  for  coordinates  */ 
regs.h.dl  =  vcolumn  =  column; 

int86 (VIDEO_INT,  firegs,  firegs);  /*  Call  BIOS  video  interrupt  */ 

} 


/*★*★*★**★ ★★**★★★*★**★**★************************* ********************** 
*  Function  :  S  E  T  C  0  L  * 


*  Task  :  Defines  the  contents  of  one  of  the  16  EGA 

*  color  registers. 


280 


Abacus 


74  BIOS  Screen  Output  Functions 


*  Input  parameters  :  -  REGNR  =  Color  register  number  * 

*  -  COLOR  *  Color  value  (0-15)  * 

*  Return  values  :  None  * 

***********************************************************************/ 


void  setcol (BYTE  regnr,  BYTE  color) 


{ 

union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 


regs.h.ah  =  0x10; 

regs.h.al  =  0; 

regs.h.bl  =  regnr; 

regs.h.bh  =  color  &  63; 

int86 (VIDEO_INT,  firegs,  &regs); 

} 


/*  Function  no.:  Set  color/attribute  */ 
/*  Sub-function  0  */ 
/*  Set  register  number  */ 
/*  Set  color  number  {  Bits  6  and  7  )  */ 
/*  Call  BIOS  video  interrupt  */ 


/*********************************************************************** 

*  Function  iSETBORDER  * 

★  * _ _ _ — - ★★ 

*  Task  :  Sets  the  border  color.  * 

*  Input  parameters:  -  COLOR  *  Color  value  (0-15)  * 

*  Return  values  :  None  * 


void  setborder(  BYTE  color  ) 


{ 

union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 

regs.h.ah  =  0x10;  /*  Function  no.:  Set  color/attribute  */ 

regs.h.al  =  1;  /*  Sub-function  1  */ 

regs.h.bh  =  color  &  15;  /*  Set  color  value  */ 

int86 (VIDEO_INT,  firegs,  &regs) ;  /*  Call  BIOS  video  interrupt  */ 

} 


/************ -k-kltlfkleielfkit*****  *****************  *************************** 

*  Function  :SETLINES  * 

*  * _ ★  ★ 

*  Task  :  Determines  the  number  of  lines.  * 

*  Input  parameters:  -  Sub- function  no.  for  calling  function  IIH  * 

*  0x11  :  8*14  character  set  * 

*  0x12  :  8*8  character  set  * 

*  0x14  :  8*16  character  set  (VGA  only)  * 

*  Return  values  :  None  * 

****★★★★★★***★★★********★★★*****★*★*****★*★*★★★★*★★★★★★***★★★★**★★★★★★★/ 


void  setlines (  BYTE  lines  ) 


{ 

union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 

regs.h.ah  =  0x11;  /*  Function  no.:  Character  generator  */ 

regs.h.al  =  lines;  /*  Sub- function  no.  */ 

regs.h.bl  =  0;  /*  Use  character  table  0  */ 

int86 (VIDEO_INT,  sregs,  &regs) ;  /*  Call  BIOS  video  interrupt  */ 

} 


/*********************************************************************** 

*  Function  :  I  S  _  E  G  A  * 

*★ _ ** 

*  Task  :  Determines  whether  an  EGA  card  is  installed.  * 

*  Input  parameters:  None  * 

*  Return  values  TRUE  when  an  EGA  or  VGA  card  is  installed,  and  * 

*  false  in  any  other  case  * 

*★*****★***★★*★ ******.  ******* *********★★★★★★★*★**************★★★★★* *★★*★/ 


BOOL  ls_ega  () 

{ 

union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 
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regs.h.ah  =  0x12;  /*  Function  number:  Determine  video  configuration  */ 

regs.h.bl  »  0x10;  /*  Sub-function  number  */ 

int86 (VIDEO_INT,  &regs,  &regs);  /*  Call  BIOS  video  interrupt  */ 

if  (  regs.h.bl  !=  0x10  )  /*  Is  it  an  EGA  or  VGA  card?  */ 

/* —  Set  pointer  in  video  RAM  for  attached  monitor - */ 

vptr  -  (VP)  MK_FP(  (mono  =  regs.h.bh)  ?  OxbOOO  :  OxbSOO,  0) ; 

return(  regs.h.bl  !-  0x10  );  /*  BL  !=  0x10  — >  EGA  or  VGA  */ 

} 


/************************************ ***************************** ****** 


*  Function  :  I  S  _  V  G  A  * 

** - ** 


Task  : 
Input  parameters: 
Return  values  : 

Info  : 


Determines  whether  a  VGA  card  is  installed. 

None 

TRUE  when  a  VGA  card  is  installed; 

FALSE  in  any  other  case. 

This  function  should  be  called  before  the 
is_ega  function,  because  the  parameters  in  the 
is_ega  function  also  apply  to  VGA  cards  (i.e., 
TRUE  will  be  returned  to  is_ega  for  a  VGA  card. 
Call  is_vga  first  in  your  own  applications. 


*  then  call  is_ega. 

***************************************** 


********** ★*★*★**★****★*/ 


BOOL  is_vga () 

{ 

union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 

regs.h.ah  =  OxlA;  /*  Function  no.:  Determine  video  configuration  */ 
regs.h.al  =  0x00;  /*  Sub-function  number  */ 

int86 (VIDEO_INT,  &regs,  &regs) ;  /*  Call  BIOS  video  interrupt  */ 

if  (  regs.h.al  ==  OxlA  &&  (  regs.h.bl==7  | |  regs.h.bl==8  )  > 

{  /*  VGA  card  connected  to  VGA  monitor?  */ 

mono  =  FALSE; 

vptr  =  (VP)  MK_FP (  OxbSOO,  0  ) ;  /*  Set  pointer  in  video  RAM  */ 

return  TRUE; 

} 

return  FALSE;  /*  No  VGA  card  installed  */ 

) 


/*********************************************************************** 
*  Function  iPRINTAT  * 

** - ** 


*  Task 


Displays  a  string  on  the  screen. 


Input 


parameters:  -  COLUMN 

-  LINE 

-  CHCOLOR 

-  STRING 


=  Display  column. 

=  Display  line. 

=  Character  attribute. 
=  Pointer  to  string. 


*  Return  values  :  None  * 

*  Information  :  -  This  function  does  not  recognize  format  specs  * 

*  as  supplied  by  PRINTF.  * 

*  -  When  the  function  reaches  the  end  of  the  * 

*  screen,  the  screen  will  not  scroll  up.  * 

***********************************************************************/ 


void  printat  (BYTE  column,  BYTE  line,  BYTE  chcolor,  char  *  string) 


register  VP  Iptr; 
register  BYTE  i; 
unsigned  newofs; 


/*  Floating  pointer  to  video  RAM  */ 
/*  points  to  the  number  of  characters  */ 
/*  Computes  new  coordinates  */ 


Iptr  »  VPOS (column,  line) ; 
for  (i=0  ;  *string  ;  ++lptr,  ++i) 
{ 

lptr->ascii_code  =  * (string++) ; 
lptr->attribute  =  chcolor; 

} 


/*  Set  pointer  in  video  RAM  */ 
/*  execute  string  */ 

/*  Character  in  video  RAM  */ 
/*  Set  character  attribute  */ 
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/* —  Compute  new  cursor  coordinates - - - */ 

vcolumn  =  (newofs  =  ((unsigned)  line  *  80  +  column  +  i>)  %  80; 
vline  “  newofs  /  80; 

} 


/It************** ******  ********************************************  ****** 

*  Function  rPRINTFAT  * 


*  Task  :  Displays  a  string  on  the  screen  (like  PRINTF) , 

*  writing  the  string  directly  to  video  RAM. 

*  Input  parameters:  -  COLUMN  =»  Display  column. 

*  -  LINE  *  Display  line. 

*  -  CHCOLOR=  Character  color. 

*  -  STRING  =  Pointer  to  the  string. 

*  -  ...  =  Additional  arguments  as  needed. 


*  Return  values  :  None  * 

*  Information  :  -  When  the  end  of  the  screen  is  reached,  the  * 

*  screen  will  not  scroll  up.  * 

*  :  -  string  can  use  the  normal  format  specifier  * 

*  group  as  used  with  PRINTF.  * 

***********************************************************************/ 


void  printfat  (BYTE  column,  BYTE  line,  BYTE  chcolor,  char  *  string,...) 

{ 

va_list  parameter;  /*  Take  parameter  list  for  VA_. . .  Macros  from  */ 
char  output [255];  /*  the  formatted,  displayed  string  */ 

va_start (parameter,  string);/*  Get  parameters  in  PARAMETER  variable  */ 
vsprintf (output,  string,  parameter) ;  /*  Convert  string  */ 

printat (column,  line,  chcolor,  output);  /*  Display  string  */ 

} 


/*********************************************************************** 

*  Function  :BLINKING  * 

*  Task  :  Defines  the  meaning  of  bit  7  of  the  attribute  * 

*  byte  of  a  character  in  text  mode.  * 

*  Input  parameters:  DOBLINK  =  TRUE  :  Blink.  * 

*  FALSE  :  Light  background  color.  * 

*  Return  values  :  none  * 

***********************************************************************/ 

void  blinking  (  BOOL  doblink  ) 

{ 

union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 

regs.h.ah  =  0x10;  /*  Function  no.:  Set  color/attribute  */ 

regs.h.al  =  0x3;  /*  Sub- function  number  */ 

regs.h.bl  =  doblink  ?  1  :  0;  /*  BL  =  1  :  blinking  */ 

int86 (VIDEO_INT,  &regs,  &regs) ;  /*  Call  BIOS  video  interrupt  */ 

} 


^*********************************************************************** 

*  Function  :  C  L  S  * 

*  * _ — _ — _ _ _ — _ — — ★ 

*  Task  :  Clears  the  screen  and  resets  the  video  mode.  * 

*  This  reset  includes  the  palette  registers,  as  * 

*  well  as  the  character  set  in  use.  * 

*  Input  parameters:  none  * 

*  Return  values  :  none  * 

***********************************************************************y 


void  els  0 

{ 

union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 

regs.h.ah  =  0x0;  /*  Function  no.:  Set  video  mode  */ 

regs.h.al  =  (  mono  )  ?  7  :  3;  /*  80x25-char  text  mode  */ 
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lnt86 (VIDEO_INT,  &regs,  &regs);  /*  Call  BIOS  video  interrupt  */ 

} 


/*********************************************************************** 


*  Function  :  N  0  K  E  Y  * 

** - ** 

*  Task  ;  Tests  for  a  depressed  key.  * 


*  Input  parameters:  none  * 

*  Return  values  :  TRUE  if  a  key  is  depressed,  otherwise  * 

*  FALSE.  * 

****************************************************************** *****^ 


BOOL  nokey  0 


#ifdef  _TURBOC _  /*  Using  TURBO  C  to  compile?  */ 

return (  bioskey(  1  )  =*  0  ) ;  /*  YES,  read  keyboard  from  BIOS  */ 

#else  /*  Using  Microsoft  C  to  ccxnpile...  */ 

return  (  _bios_keybrd  (  _KEYBRD_READY  )  ==  0  ) ;  /*  Read  from  BIOS  */ 

fendif 


/*★★★******************************************************************* 


*  Function  :  E  G  A  V  G  A  * 

** - ** 

*  Task  :  Demonstrates  the  application  of  EGA/VGA  BIOS  * 

*  functions  * 


*  Input  parameters:  VGA  :  TRUE  when  working  with  VGA  card  * 

*  FALSE  in  any  other  case  * 

*  Return  values  :  none  * 

*********************************************************************** ^ 


void  egavga (  BOOL  VGA  ) 
{ 


static 

BYTE  font [120] [14] 

=  { 

/* 

Character  definition  for 

logo 

*/ 

{  0, 

0, 

255, 

62, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

31], 

/* 

T 

*/ 

{  0, 

0, 

252, 

7, 

1, 

1, 

1, 

1, 

1, 

1, 

1, 

1, 

7, 

252], 

/* 

h 

*/ 

{  0, 

0, 

0, 

0, 

129, 

195, 

195, 

199, 

199, 

206, 

206, 

142, 

14, 

14}, 

/* 

e 

*/ 

{  0, 

0, 

62, 

193, 

128, 

128, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

s 

*/ 

{  0, 

0, 

16, 

144, 

112, 

48, 

48, 

16, 

16, 

0, 

0, 

0, 

0, 

0], 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0], 

/* 

*/ 

(  0, 

0, 

3, 

0, 

0, 

•  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

1 

*/ 

{  0, 

0, 

254, 

248, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

112}, 

/* 

i 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

252, 

61, 

30, 

30, 

28}, 

/* 

n 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

248, 

6, 

7, 

3, 

3}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

7, 

0, 

0, 

0, 

128}, 

/* 

s 

*/ 

{  0, 

0, 

32, 

96, 

224, 

224, 

224, 

224, 

224, 

254, 

224, 

224, 

224, 

224}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

1, 

6, 

12, 

28, 

24}, 

/* 

c 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

240, 

28, 

6, 

7, 

7}, 

/* 

o 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

63, 

15, 

7, 

7, 

7}, 

/* 

n 

*/ 

{  0, 

0, 

0/ 

0, 

0, 

0, 

0, 

0, 

0, 

30, 

39, 

71, 

135, 

128}, 

/* 

t 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

126, 

30, 

15, 

15, 

14}, 

/* 

a 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

124, 

131, 

3, 

1, 

1}, 

/* 

i 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

129, 

131, 

195}, 

/* 

n 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

62, 

193, 

128, 

0}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

192, 

224, 

224}, 

/* 

t 

*/ 

{  0, 

0, 

248, 

120, 

56, 

56, 

56, 

56, 

56, 

56, 

56, 

56, 

56, 

56}, 

/* 

h 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

31, 

48, 

48, 

48, 

48}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

196, 

52, 

12, 

4, 

4}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

b 

*/ 

{  0, 

0, 

0, 

0, 

0/ 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

i 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

t 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

P 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

a 

*/ 

{  28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62, 

255, 

0, 

0, 

0, 

0}, 

/* 

t 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

128, 

0, 

0, 

0, 

0}, 

/* 

t 

*/ 

{  14, 

14, 

14, 

7, 

7, 

3, 

3, 

1, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

128, 

128, 

193, 

62, 

0, 

0, 

0, 

0}, 

/* 

r 

*/ 

{  0, 

0, 

0, 

0, 

16, 

16, 

32, 

64, 

128, 

0, 

0, 

0, 

0, 

0}, 

/* 

n 

*/ 
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{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0), 

/* 

s 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

3, 

0, 

0, 

0, 

0), 

/* 

*/ 

{112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

248, 

254, 

0, 

0, 

0, 

0), 

/* 

f 

*/ 

{  28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62, 

255, 

0, 

0, 

0, 

0), 

/* 

o 

*/ 

{  3, 

3, 

3, 

3, 

3, 

3, 

3, 

3, 

7, 

159, 

0, 

0, 

0, 

0), 

/* 

r 

*/ 

(128, 

128, 

128, 

128, 

128, 

128, 

128, 

128, 

192, 

240, 

0, 

0, 

0, 

0}, 

/* 

*/ 

{224, 

224, 

224, 

224, 

224, 

224, 

96, 

112, 

49, 

30, 

0, 

0, 

0, 

0), 

/* 

t 

*/ 

{  56, 

63, 

56, 

56, 

56, 

24, 

92, 

76, 

134, 

1. 

0, 

Of 

0, 

0), 

/* 

h 

*/ 

{  7, 

255, 

0, 

0, 

0, 

0, 

1, 

2, 

12, 

240, 

0, 

0, 

0, 

0}, 

/* 

e 

*/ 

{  7, 

7, 

7, 

7, 

7, 

7, 

7, 

7, 

15, 

63, 

0, 

0, 

0, 

0), 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

128, 

224, 

0, 

0, 

0, 

0), 

/* 

c 

*/ 

{  14, 

14, 

14, 

14, 

14, 

14, 

14, 

14, 

31, 

127, 

0, 

0, 

0, 

0), 

/* 

h 

*/ 

{  1, 

1, 

1, 

1, 

1, 

1, 

1, 

1, 

3, 

207, 

0, 

0, 

0, 

0), 

/* 

a 

*/ 

{192, 

192, 

192, 

193, 

193, 

195, 

195, 

193, 

225, 

248, 

0, 

0, 

0, 

0}, 

/* 

r 

*/ 

{  0, 

7, 

120, 

192, 

192, 

128, 

128, 

192, 

195, 

124, 

0, 

0, 

0, 

0), 

/* 

a 

*/ 

{224, 

224, 

224, 

224, 

224, 

224, 

224, 

240, 

112, 

29, 

0, 

0, 

0, 

0), 

/* 

c 

*/ 

{  56, 

56, 

56, 

56, 

56, 

56, 

56, 

56, 

124, 

255, 

0, 

0, 

0, 

0), 

.  /* 

t 

*/ 

{  31, 

31, 

31, 

0, 

0, 

64, 

96, 

96, 

112, 

71, 

0, 

0, 

0, 

0), 

/* 

e 

*/ 

{  0, 

224, 

248, 

252, 

28, 

.  12, 

4, 

12, 

24, 

224, 

0, 

0, 

0, 

0}, 

/* 

r 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0), 

/* 

s 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0), 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

n 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0), 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0), 

/* 

d 

*/ 

{  0, 

0, 

252, 

60, 

30, 

30, 

30, 

23, 

23, 

23, 

19, 

19, 

19, 

17}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

1/ 

1, 

1, 

130, 

130, 

130, 

196}, 

/* 

d 

*/ 

{  0, 

0, 

126, 

120, 

240, 

240, 

240, 

112, 

112, 

112, 

112, 

112, 

112, 

112}, 

/* 

*/ 

{  0, 

0, 

28, 

28, 

28, 

0, 

0, 

0, 

0, 

252, 

60, 

28, 

28, 

28}, 

/* 

i 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

1, 

6, 

12, 

28, 

24}, 

/* 

n 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

240, 

12, 

2, 

7, 

7}, 

/* 

*/ 

{  0, 

0, 

63, 

15, 

7, 

7, 

7, 

7, 

7, 

7, 

7, 

7, 

7, 

7}, 

/* 

t 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

62, 

65, 

129, 

128, 

0}, 

/* 

h 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

128, 

192, 

192, 

224}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

63, 

64, 

224, 

224, 

224}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

192, 

96, 

112, 

112}, 

/* 

1 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

7, 

24, 

48, 

112, 

96}, 

/* 

o 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

192, 

112, 

24, 

28, 

28}, 

/* 

g 

*/ 

{  0, 

0, 

252, 

60, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

28}, 

/* 

o 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0}, 

/* 

a 

*/ 

{  0, 

0, 

63, 

56, 

48, 

48, 

32, 

32, 

32, 

0, 

0, 

0, 

0, 

0}, 

/* 

t 

*/ 

{  0, 

0, 

255, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

112}, 

/* 

*/ 

{  0, 

0, 

225, 

225, 

97, 

32, 

32, 

32, 

32, 

15, 

3, 

If 

If 

l}f 

/* 

t 

*/ 

{  0, 

0, 

192, 

192, 

192, 

0, 

0, 

0, 

0, 

192, 

193, 

195, 

195, 

195}, 

/* 

h 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

252, 

3, 

0, 

Of 

0}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

64, 

65, 

195, 

71, 

70}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

124, 

131, 

0, 

If 

l}f 

/* 

c 

*/ 

{  0, 

0, 

15, 

3, 

1, 

1, 

1, 

1, 

1, 

1/ 

1, 

129, 

193, 

193}, 

/* 

e 

*/ 

{  0, 

0, 

192, 

192, 

192, 

192, 

192, 

192, 

192, 

207, 

208, 

224, 

224, 

192}, 

/* 

n 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

128, 

96, 

112, 

48, 

56}, 

/* 

t 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

3, 

12, 

24, 

56, 

48}, 

/* 

e 

*/ 

{  0, 

0, 

0, 

0, 

0, 

’  0, 

0, 

0, 

0, 

224, 

56, 

12, 

14, 

14}, 

/* 

r 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

126, 

30, 

14, 

15, 

15}, 

/* 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

60, 

78, 

142, 

14, 

0}, 

/* 

o 

*/ 

{  17, 

17, 

16, 

16, 

16, 

16, 

16, 

16, 

48, 

254, 

0, 

0, 

0, 

0}, 

/* 

f 

*/ 

{196, 

196, 

232, 

232, 

232, 

112, 

112, 

80, 

32, 

35, 

0, 

0, 

0, 

0}, 

/* 

*/ 

(112, 

112, 

112, 

112, 

112, 

112, 

112, 

112, 

248, 

254, 

0, 

0, 

0, 

0}, 

/* 

t 

*/ 

{  28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62, 

255, 

0, 

0, 

0, 

0}, 

/* 

h 

*/ 

{  56, 

56, 

56, 

56, 

56, 

24, 

28, 

12, 

6, 

129, 

0, 

0, 

0, 

0}, 

/* 

e 

*/ 

{  7, 

0, 

0, 

0, 

0, 

0, 

1, 

2, 

12, 

240, 

0, 

0, 

0, 

0}, 

/* 

*/ 

{  7, 

7, 

7, 

7, 

7, 

7, 

7, 

7, 

15, 

63, 

0, 

0, 

0, 

0}, 

/* 

s 

*/ 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

129, 

231, 

0, 

0, 

0, 

0}, 

/* 

c 

*/ 

{224, 

224, 

224, 

224, 

224, 

225, 

225, 

224, 

240, 

252, 

0, 

0, 

0, 

0}, 

/* 

r 

*/ 

{  0, 

3, 

60, 

224, 

224, 

192, 

192, 

224, 

225, 

62, 

0, 

0, 

0, 

0}, 

/* 

e 

*/ 

{112, 

240, 

112, 

112, 

112, 

112, 

112, 

120, 

184, 

14, 

0, 

0, 

0, 

0}, 

/* 

e 

*/ 

{224, 

255, 

224, 

224, 

224, 

96, 

112, 

48, 

24, 

7, 

0, 

0, 

0, 

0}, 

/* 

n 

*/ 

{  28, 

252, 

0, 

0, 

0, 

0, 

4, 

8, 

48, 

192, 

0, 

0, 

0, 

0}, 

/* 

*/ 

{  28, 

28, 

28, 

28, 

28, 

28, 

28, 

28, 

62, 

255, 

0, 

0, 

0, 

0}, 

{  0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

0, 

128, 

0, 

0, 

0, 

0}, 
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o 

p 

o 

o 

p 

o 

o 

o 

p 

p 

0, 

0, 

0, 

0}, 

(  0,  0,  0,  0,  0,  0,  0,  0,  0,  3, 

0, 

0, 

0, 

0), 

(112,112,112,112,112,112,112,112,248,254, 

0, 

0, 

0, 

0}, 

{  1,  1,  1,  1,  1,  1,  1,  1,  3,  15, 

0, 

0, 

0, 

0), 

(193,193,192,192,192,194,195,195,227,250, 

0, 

0, 

0, 

0}, 

(240,254,255,  15,  1,  0,  0,  0,129,126, 

0, 

0/ 

0, 

0), 

(  14,  14,142,206,206,198,  71,195,129,  0, 

0, 

0, 

0, 

0}, 

(  1,  0,  0,  0,  0,  0,  0,  0,131,124, 

0, 

0, 

0, 

0), 

(193,  1,  1,  1,  1,  1,  65,129,  3,  15, 

0, 

0, 

0, 

0}, 

(192,192,192,192,192,192,192,192,224,249, 

0, 

0, 

0/ 

0), 

(  56,  56,  56,  56,  56,  56,  56,  56,124,255, 

0, 

0, 

0, 

0}, 

(112,127,112,112,112,  48,  56,  24,  12,  3, 

0, 

0, 

0, 

0), 

(  14,254,  0,  0,  0,  0,  2,  4,  24,224, 

0, 

0, 

0, 

0), 

(  14,  14,  14,  14,  14,  14,  14,  14,  31,127, 

0, 

0, 

0, 

0), 

(  0,  0,  0,  0,  0,  0,  0,  0,  0,192, 

0, 

0, 

0, 

0} 

); 


union  REGS  regs;  /*  Processor  register  for  the  interrupt  call  */ 
unsigned  1,  j,  Jc;  /*  Loop  counter  */ 
double  delay;  /*  Loop  counter  for  PAUSE  */ 

/* —  Prepare  screen - */ 


cls(>;  /*  Clears  screen  */ 
blinking  (  FALSE  >;  /*  Light  background  color  Instead  of  blinking  */ 
setcur(0,  0);  /*  Move  cursor  to  upper  left  corner  */ 


/* —  Install  EGA  and  VGA  hardcopy  routine - */ 

regs. h. ah  =  0x12;  /*  Function  no.:  Alternate  Select  */ 
regs.h.bl  =  0x20;  /*  Sub-funct.  0x20  =  Install  hardcopy  routine  */ 
int86(VIDEO_INT,  &regs,  &regs);  /*  Call  BIOS  video  interrupt  */ 


if  (  VGA  ) 

{ 

regs. h. ah  =  0x12; 
regs.h.bl  =  0x30; 
regs.h.al  =  1; 

int86 (VIDEO_INT,  &regs,  &regs) ; 
setlines (  0x11  ) ; 

} 


/*  Check  for  compatibility  */ 
/*  and  check  custom  characters  */ 
/*  VGA  card  in  350-llne  mode  */ 
/*  Toggle  EGA  card  */ 

/*  Call  BIOS  video  Interrupt  */ 

/*  Enable  8x14  character  set  */ 


chardef(128,  0,  14,  120,  (BYTE  far  *>  font);  /*  Define  characters  */ 


for  (i=0;  i<250;  ++i) 

{ 

print  fat (GETCS ( ) ,  GETCZ ( > 
print fat (GETCS (> ,  GETCZ (> 

} 

for  (i=10;  1<16;  ++1) 
printat (22,  i,  0,  " 
for  (k=128,  i=0;  i<4;  ++1) 

{ 

for  (j=0;  j<30;  ++j) 
printfat (j+24,  i+11,  15, 


/*  Execute  loop  250  times 
/*  Write  color  blocks  to  video  RAM 
((i  %  14)  +  1)  «  4,  ••  •*); 

0,  -  ••); 

/*  Allocate  space  for  logo 

-); 

/*  The  logo  consists  of  ASCII 
/*  characters  128-248 


••%c'',  k++); 


} 

printat (1,  1,  15,  "The  most  important  characters  are") ; 

printat  (1,  2,  15,  "still  present  despite  the  logo!  ") ; 

printat  (1,  3,  15,  ”  ") ; 

printatd,  4,  15,  "  !\"#$%&' ()  *+-./O123456789:;<=>?0  "); 

printat  (1,  5,  15,  "  ABCDEFGHIJKLMNOPQRSTUVXXYZ  [W] '"_  ")  ; 

printat  (1,  6,  15,  "  'abcdefghijklmnopqrstuvxyz{ | }-  ") ; 

printat (33,  21,  15,  "  ") ; 

printat  (33,  22,  15,  "  Press  any  key  to  end  the  program.  ") ; 

printat  (33,  23,  15,  "  **); 

set cur (  34,  22); 


*/ 

*/ 


*/ 

*/ 

*/ 


/* —  Change  colors  in  the  color  blocks 


•*/ 


i 


0; 


/*  starting  value  for  color  register  */ 
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while  (  nokeyO  )  /*  Repeat  until  the  user  presses  a  key  */ 

{ 

for  (  delay»0.0;  delay  <  PAUSE;  ++delay  ) 


++i;  /*  Increment  color  value  for  the  first  register 

for  (j=l;  j<15;  ++j)  /*  Go  through  registers  1  to  14 

{ 


setcol(j,  i+j  &  63); 
if  (  I  nokey  ()  ) 
break; 


/*  Write  color  value  in  register 
/*  Key  pressed? 
/*  YES  — >  Stop  loop  before  restarting 


} 


} 


*/ 

*/ 

*/ 

*/ 

*/ 


if  (  VGA  ) 

{ 

regs.h.ah  *  0x12; 
regs.h.bl  «  0x30; 
regs.h.al  *  2; 
int86  (VIDEO_INT,  firegs. 


/*  Go  into  400  line  mode  */ 
/*  Enable  VGA  card  */ 


&regs) ;  /*  Call  BIOS  video  interrupt  */ 


setlines (  0x14  );  /*  Enable  8*16  character  set  */ 

} 


cls();  /*  Clear  screen  */ 

} 


/********* ******  ***************  *********************************** *****/ 
/**  MAIN  PROGRAM  **/ 

/**********************************************************************/ 


void  mainO 

{ 

if  (  is_vga()  ) 
egavga  (  TRUE  ) ; 
else 


{ 

if  (  is_ega()  ) 

{ 

if  (  getmonO  «  EGA  ) 
egavga (  FALSE  )  ; 
else 


/*  Is  there  a  VGA  card  installed?  */ 
/*  YES  */ 

/*  No  VGA  installed  -  go  on  */ 

/*  Is  there  an  EGA  card  installed?  */ 

/*  YES  */ 

/*  Is  there  an  EGA  monitor  connected?  */ 
/*  YES,  start  demo  */ 


} 


{  /*  wrong  monitor  */ 

printf ("This  program  functions  only  with  an\n"); 
printf ("EGA  monitor.  \n"); 

} 

} 

else  /*  If  no  EGA  or  VGA  card  connected  */ 

printf (  "ATTENTION!  There  is  neither  an  EGA  nor  a  " 

"  VGA  card  installed. \n"  ); 

} 


Assembler  listing:  EGAVGACA.ASM 


.  ****************************** ******************************** ******** 
;*  EGAVGACA  * 


Task 


Author 
Developed  on 
Last  update 


Generates  a  functions  for  custom  designing 
characters. 


_ * 


MICHAEL  TISCHER 

09/25/1988 

06/07/1988 


*  Assembly  :  MASM  EGAVGACA;  * 

*  ...  Link  with  a  C  program  whose  memory  model  * 

*  has  been  set  to  SMALL  * 

********************************************************************** 
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Segment  declarations  for  the  C  program 


IGROUP  group  _text  ;Addition  to  program  segment 

DGROUP  group  const, _bss,  _data  ; Addition  to  data  segment 

assume  CS: IGROUP,  DS: DGROUP,  ES: DGROUP,  SS: DGROUP 

CCWST  segment  word  public  'CONST '/This  segment  includes  all  read-only 
CC»JST  ends  ;  constants 

_BSS  segment  word  public  'BSS'  /This  segment  includes  all  un-initial- 
_BSS  ends  /ized  static  variables 


DATA 

DATA 


segment  word  public  'DATA' 


This  segment  includes  all  initialized 
global  and  static  variables 


ends 


_TEXT  segment  byte  public  'CODE'  /Program  segment 


public  _chardef 


—  CHARDEF:  Defines  the  appearance  of  a  character 


/—  Call 

from  C 

:  void  chardef ( 

BYTE  ascii,  BYTE  table,  BYTE  lines. 

/  “ 

/ —  Return  value:  none 

BYTE  amount,  BYTE  far  *  buf ) / 

_chardef 

proc 

near 

s  frame 

struc 

/Stack  access  structure 

bptr 

dw  ? 

/Take  BP 

ret_adr 

dw  ? 

/Return  address  of  calling  program 

ascii 

dw  ? 

/ASCII  code  of  character 

table 

dw  ? 

/Number  of  character  table 

lines 

dw  ? 

/Character  matrix  height 

amount 

dw  ? 

/Number  of  characters  to  be  defined 

bufptr 

dd  ? 

/FAR  pointer  to  buffer 

s  frame 

ends 

/End  of  structure 

frame 

equ 

bp  -  bptr  ] 

/Addresses  elements  of  structure 

push 

bp 

/Push  BP  onto  stack 

mov 

bp,  sp 

/Transfer  SP  to  BP 

mov 

ax,1100h 

/Function  no.  IIH,  sub-funct.  0 

mov 

bh,byte  ptr 

frame. lines 

/Character  matrix  height 

mov 

bl,byte  ptr 

frame. table 

/Number  of,  character  table 

mov 

cl, byte  ptr 

frame . amount 

/Number  of*  characters 

xor 

ch,  ch 

mov 

xor 

dl,byte  ptr 
dh,  dh 

frame. ascii 

/Get  ASCII  code  of  character 

les 

bp,  frame,  buf  ptr  /Buffer 

address  to  ES:BP 

Int 

lOh 

/Call  EGA  BIOS  video  interrupt 

pop 

bp 

/Pop  BP 

off  of  stack 

ret 

/Return 

to  C  program 

chardef  endp 


text  ends 

end 


/End  of  code  segment 
/End  of  program 
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7.5  Determining  System  Configuration  using  BIOS 

Some  programs  (e.g.,  copy  programs)  must  determine  how  many  disk  drives  are 
connected  to  the  PC,  or  how  much  RAM  exists  on  the  main  circuit  board  or 
motherboard.  This  information  can  be  obtained  with  the  help  of  BIOS  interrupt 
IIH. 

The  content  of  individual  registers  is  not  important  during  the  call  of  this 
interrupt,  since  neither  the  function  number  nor  another  argument  must  be  passed. 

The  configuration,  which  is  determined  during  the  system  booting  process,  is 
returned  in  the  AX  register.  The  individual  bits  of  this  register  contain  the 
following  information: 


Bit (s) 

0 

Equal  to  1  if  1  or  more  disk  drives  are  available 

1 

Unused 

2  &  3 

RAM  memory  on  the  main  circuit  board 

00  =  16K 

01  =  32K 

10  =  48K 

11  =  64K 

4  &  5 

01:  40*25  characters  -  color  card 

02:  80*25  characters  -  color  card 

03:  80*25  characters  -  mono  card 

Indicates  number  of  disk  drives  in  system  if  bit  0  is 

1 

00  =  1  disk  drive 

01  =  2  disk  drives 

10  =  3  disk  drives 

11  =  4  disk  drives 

8 

Equal  to  0  when  DMA  chip  is  available 

9-11 

Number  of  RS-232  cards  attached 

12 

Equal  to  1  if  joystick  attached 

13 

Unused 

14  &  15 

indicates  the  number  of  printers 

While  this  bit  assignment  is  the  same  for  the  PC  and  the  XT,  it  differs  from  the 
configuration  word  returned  by  the  AT.  To  interpret  the  content  of  the  AX  register 
correctly,  you  must  know  the  model  of  the  computer  being  tested. 


289 


7.  The  BIOS 


PC  System  Programming 


Bit 

Meaning 

00 

Equal  to  1  if  1  or  more  disk  drives  are  available 

01 

Equal  to  1  if  system  has  a  math  coprocessor 

02-03 

Unused 

04-05 

Video  mode  during  system  boot 

00:  Unused 

01:  40*25  characters  -  color  card 

02:  80*25  characters  -  color  card 

03:  80*25  characters  -  mono  card 

06-07 

Indicates  number  of  disk  drives  in  system  if  bit  0  is 

1 

00  =  1  disk  drive 

01  =  2  disk  drives 

10  =  3  disk  drives 

11  =  4  disk  drives 

08 

Unused 

09-11 

Number  of  RS-232  cards  attached 

12-13 

Unused 

14-15 

indicates  the  number  of  printers 

Do  not  use  this  function  to  sense  the  current  video  mode,  since  it  only  indicates 
the  video  mode  switched  on  during  system  booting.  Function  15H  of  interrupt 
lOH  provides  the  number  of  the  current  video  mode. 
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7.6  Determining  Available  RAM  using  the  BIOS 

While  interrupt  IIH  only  returns  the  amount  of  RAM  on  the  main  circuit  board, 
interrupt  12H  obtains  the  amount  of  RAM  available  in  the  entire  system.  The 
total  amount  of  RAM  from  the  main  circuit  board  and  any  memory  expansion 
cards  are  returned.  The  DIP  switch  settings  on  the  memory  boards  determine  the 
amount  of  memory  reported  available  on  the  PC  and  XT.  The  interrupt  routines 
derive  the  amount  of  RAM  on  an  AT  by  reading  one  of  the  64  memory  locations 
on  the  battery  powered  realtime  clock. 

Memory  limits 

This  method  determines  RAM  below  the  1  megabyte  limit  only.  The  8088’s 
addressing  capability  limits  memory  to  1  megabyte,  so  the  PC  and  XT  can  report 
on  the  entire  memory  available.  The  AT’s  80286  processor  can  manage  up  to  16 
megabytes  of  memory.  However,  interrupt  12H  cannot  report  on  any  RAM  beyond 
1  megabyte. 

The  memory  size  returned  is  passed  in  the  AX  register  as  a  multiple  of  IK  (1024 
bytes,  not  1000  bytes).  For  example,  if  the  AX  register  contains  256,  you  have 
256K  of  RAM  available  in  your  PC. 

Demonstration  programs 

The  three  program  listings  in  this  section  are  practical  examples  of  the  interrupts 
described  in  die  preceding  section.  The  three  programs,  which  were  written  in 
BASIC,  Pascal  and  C,  are  identical  in  their  basic  design. 

They  test  the  model  identification  byte  in  memory  location  FOOOiFFFE  to 
determine  whether  the  computer  is  a  PC,  XT  or  AT.  The  equipment  designation 
appears  on  the  screen.  This  model  identification  acts  as  the  basis  for  identifying  the 
processor  type  as  well.  The  program  assumes  that  an  AT  has  an  80286  and  all 
other  PCs  have  an  8088  processor.  During  the  next  step  in  the  programs,  interrupt 
12H  determines  the  amount  of  RAM  on  the  circuit  board  and  returns  that  amount 
As  mentioned  above,  the  AT  can  have  additional  RAM  memory  beyond  the  1 
megabyte  limit.  Each  program  tests  for  that  additional  RAM  if  the  equipment 
designation  indicates  an  AT.  The  programs  use  function  88H  of  interrupt  15H  (see 
Appendix  B  for  detailed  documentation).  For  the  moment,  all  you  need  to  know  is 
that  this  function  passes  the  amount,  in  multiples  of  IK,  of  RAM  above  the  1 
megabyte  limit  to  Ae  AX  register. 

After  displaying  this  information,  interrupt  IIH  determines  the  equipment 
configuration.  The  last  task  of  the  program  consists  of  filtering  out  the 
information  encoded  in  the  bits  of  the  configuration  word  and  displaying  it  on  the 
screen. 

To  keep  the  program  from  becoming  too  long,  the  programs  limit  themselves  to 
the  identical  bits  of  the  configuration  words  in  the  rc,  XT  and  AT.  For  example. 
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the  programs  skip  the  AT  information  concerning  the  availability  of  a  math 
coprocessor. 


You  may  want  to  rewrite  this  program  so  that  it  displays  all  the  information 
contained  in  the  configuration  word  according  to  computer  type. 

The  comments  in  each  listing  should  answer  any  questions  you  may  have  about 
program  flow. 


BASIC  listing:  CONFIGB.BAS 


100 

110 

120 

130 

140 

150 

160 

170 

180 

190 

200 

210 

220 

230 

240 

250 

260 

270 

280 

290 

300 

310 

320 

330 

340 

350 

360 

370 

380 

390 

400 

410 

420 

430 

440 

450 

460 

470 

480 

490 

500 

510 

520 

525 

530 

540 

550 

560 

570 

580 

590 

600 

610 

620 


•  ***************************************************************** • 
•*  CONFIGB  *' 


'  *  Task 


:  Displays  the  Configuration  of  the  PC 


•*  Author  :  MICHAEL  TISCHER 

'*  developed  on  :  7.20.87 

'*  last  Update  :  9.21.87 


•  ***************************************************************** • 


CLS  :  KEY  OFF 

PRINT  "WARNING:  This  program  should  only  be  started  if  the  GWBASIC 
PRINT"was  started  from  the  DOS  level  with  <GWBASIC  /m:60000>." 
PRINT  :  PRINT"If  this  was  not  the  case,  then  input  <s>  for  Stop." 
PRINT" Else  press  any  key  ..."; 

A$  *  INKEY$  :  IF  A$  =  "s"  THEN  END 
IF  A$  »  THEN  250 

GOSUB  60000  'Install  Function  for  interrupt  Call 

CLS  'Clear  Screen 

DEF  SEG  =  &HF0O0  ' BlOS-Segment 

PRINT  "CONFIG  (c)  1987  by  Michael  Tischer" 

PRINT 

PRINT  "Configuration  of  Your  PC" 

PRINT  " - 


PRINT  "PC-Type 
IF  PEEK(&HFFFE)  = 
IF  PEEK(&HFFFE)  = 
IF  PEEK(&HFFFE)  = 
PRINT  "unknown" 
PRINT  "Processor 
IF  PEEK(&HFFFE>  = 
INR%  =  &H12 
DEF  SEG 


&HFF  THEN  PRINT  "PC" 
&HFE  THEN  PRINT  "XT" 
&HFC  THEN  PRINT  "AT" 


";  'determine  PC  type 
GOTO  390 
GOTO  390 
GOTO  390 


:  80"; 

&HFC  THEN  PRINT  "286"  ELSE  PRINT  "88" 

'BI os-interrupt  reads  RAM  size 
'Set  BASIC-Segment  again 
CALL  lA (INR%, RAMHI%,  RAMLO%,  Z%, Z%,  Z%, Z%,  Z%,  Z%,  Z%, Z%,  Z%,  Z%) 

PRINT  "RAM-Memory  (Main  Circuit  Board)  :";RAMHI%*256+RAMLO%;"KB" 

DEF  SEG  =  &HF000  ' BlOS-Segment 

IF  PEEK(&HFFFE)  <>  &HFC  THEN  520  'branch  if  not  AT 
DEF  SEG  'set  BASIC-Segment  again 

INR%  *  &H15  'Call  Cassette  interrupt 

RAMHI%  “  &H88  'Function  for  reading  of  HI-RAM  size 

CALL  lA  (INR%, RAMHI%, RAMLO%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%) 

PRINT  "Additional  RAM-Memory  :";RAMHI%*256+RAMLO%;"KB  beyond  1  MB" 

DEF  SEG  'Set  BASIC-Segment  again 

INR%  =  &H11  'BlOS-interrupt  reads  Configuration 

CALL  lA  (INR%,CONFHI%,CONFLO%, Z%,  Z%, Z%, Z%,  Z%, Z%, Z%, Z%, Z%, Z%) 

PRINT  "Video  mode  after  Start  : 

IF  CONFLO%  AND  48  *  0  THEN  PRINT" undefined"  :  GOTO  590 

IF  CONFLO%  AND  48  *  16  THEN  PRINT"40*25  Character,  Color-Card"  :  GOTO  590 
IF  CONFLO%  AND  48  »  32  THEN  PRINT"80*25  Character,  Color  Card"  :  GOTO  590 
PRINT"80*25  Character,  Mono-Card" 

PRINT"Disk  drives  :";INT(CONFLO%/64)+l 

PRINT" RS232  cards  :";INT (CONFHI%/2)  AND  3 

PRINT"Printer  cards  :";INT(CONFHI%/64) 

PRINT 
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630  END 
640  • 

60000  ' ' 
60010  '*  Initialize  the  Routine  for  interrupt -Call  *' 

60020  •* - *• 

60030  '*  Input:  none  *' 

60040  '*  Output:  lA  the  Start  address  of  the  interrupt-Routine  *' 

60050  ' ★★****★****★★★★★★*★★*★★★★★*****★**★****★*★*******★★************ ' 
60060  • 

60070  IA-60000!  'Start  address  of  the  Routine  in  the  BASIC-Segment 

60080  DEF  SEG  'Set  BASIC-Segment 

60090  RESTORE  60130 

60100  FOR  1%  -  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'Poke  Routine 
60110  RETURN  'back  to  Caller 

60120  ' 

60130  DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

60140  DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

60150  DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

60160  DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 
60170  DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 
60180  DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

60190  DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

60200  DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

60210  DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

60220  DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

60230  DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 

Pascal  listing:  CONFIGP.PAS 

{ ************★*★******************************************★★★*★***★★**} 


[*  CONFIGP  PASCAL  *] 

- 

{*  Task  :  Outputs  the  Configuration  of  the  PC  on  the  *} 

{*  Display  Screen  *} 

- 

{*  Author  :  MICHAEL  TISCHER  *} 

developed  on  :  7/7/87 

{*  last  Update  :  5/18/89  *} 


V  ^ 

program  CONFIGP; 

Uses  Crt,  Dos;  {  Add  DOS  and  Crt  } 


*****★**★★★*★★★***★★★******★★*★★*★**★*******★★*★★****★***★★****★**★★★ j 

*  PRINTCONFIG:  Display  PC's  configuration  *} 

*  Input  :  none  *} 

*  Output  :  none  *} 

*  Info  :  The  configuration  output  depends  on  the  PC  type  *} 

********************************************************************* '^ 


procedure  PrintConfig; 


var  AT  :  boolean;  {  is  the  PC  an  AT?  } 

^Regs  :  Registers;  {  Register  variable  for  interrupt  call  } 

begin 

clrscr;  {  Clear  screen  } 

if  mem[$F000:$FFFE]  *  $FC  then  AT  :=  true  {  test  if  AT  or  } 

else  AT  :*  false;  {  PC  or  XT  } 

writelnC Configuration  of  this  PC'); 

wricelnC - - ') ; 

write ( ' PC-Type  :  ' ) ; 

case  mem[$F000:$FFFE]  of  {  Read  PC  type  again  } 

$FF  :  writelnC  PC');  {  $FF  is  a  PC  } 

$FE  :  writeln('XT');  {  $FE  is  an  XT  } 

$FC  :  writeln('AT')  {  $FC  is  an  AT  } 

else  writeln ( 'Unknown' ) ; 
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end; 

write ( ' Processor 
if  AT  then  writelnC 80286') 
else  writeln ('8088')  ; 
intr($12,  Regs); 
writeln  ( '  RAM-Memory 
if  AT  then 
begin 

Regs. ah  $88;  { 

Intr($15,  Regs); 
writeln ('additional  RAM 
end; 

Intr($ll,  Regs) ; 
write ('Video  mode  after  start  :  '); 
case  Regs.al  and  48  of 
0  :  writeln ( 'undefined') ; 

writeln ('40x25  character  color  card'); 
writeln (' 80x25  character  color  card'); 
writeln ('80x25  character  mono  card') 


:  INTEL  '); 

{  the  AT  has  an  80286,  } 
{  PC  and  XT  have  an  8088  processor  } 

:  ',Regs.ax,  '  KB'); 

{  is  the  PC  an  AT?  } 
{  YES  } 

Function  number  for  additional  RAM  size  } 
{  Call  BIOS  cassette  interrupt  } 
:  ',Regs.ax, '  KB  beyond  1  MB'); 

{  Call  BIOS  configuration  interrupt) 


{  Determine  video  mode  } 


16 
32 
48  ; 
end; 

writeln ('Disk  drives 
writeln ( ' RS-232  cards 
writeln ( 'Printer  cards 
end; 


succ (Regs.al  shr  6  and  3)); 
Regs. ah  shr  1  and  3); 

Regs. ah  shr  6) 


I  ********** *★**★★** ********************************* *★*★★***★★★******* } 

{*  MAIN  PROGRAM  *) 

^ *********************************************************** ***★*★*★**) 


begin 

PrintConfig; 

end. 


{  Display  configuration  ) 


C  listing:  CONFIGC.C 


/*********************************************************************/ 
/*  CONFIGC  */ 

*/ 
/ 

*/ 
/ 

*/ 
*/ 
*/ 
.*/ 

/ 

*/ 
*/ 
*/ 
*/ 


/ 

/ 

/ 

/ 

/ 

/* 

/ 

/ 

/* 

/ 

/* 

/ 

/ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  With  the  RUN  command  in  the  Ccanmand  Line  */ 

/*********************************************************************/ 


Task  : 

Outputs  the  configuration  of  the  PC  on  the 
Display  Screen 

Author 

:  MICHAEL  TISCHER 

developed  on 

:  8.13.87 

last  Update 

:  9.21.87 

(MICROSOFT  C) 
Creation 

:  MSC  CONFIGC 

LINK  CONFIGC  PEPO; 

Call 

:  CONFIGC 

♦include  <dos.h> 
♦include  <io.h> 


/*  Include  Header-Files  */ 


extern  short  int  PeekB () ; 


/*  PEEKB  linked  with  Microsoft  C  */ 


♦define  FALSE  0 
♦define  TRUE  1 


/*  Constants  make  reading  the  */ 
/*  Program  text  easier  */ 


/*********************************************************************/ 
/*  CLS:  Clear  Screen  and  Cursor  to  upper  left  corner  */ 

/*  Input  :  none  */ 

/*  Output  :  none  */ 

/*********************************************************************/ 


void  Cls() 
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{ 

union  REGS  Register;  /*  Register-Variable  for  interrupt -Call  */ 


Register.h.ah  =  6; 
Register. h.al  =  0; 
Register.h.bh  *  7; 
Register. x.cx  =  0; 
Register. h.dh  =  24; 
Register. h.dl  =  79; 
int86(0xl0,  &Register, 


/*  Function  number  for  Scroll -UP  */ 
/*  0  for  clear  */ 
/*  white  characters  on  black  background  */ 
/*  left  upper  screen  corner  */ 
/*  Coordinates  of  the  lower  */ 
/*  right  screen  corner  */ 
sRegister) ;  /*  Call  BlOS-Video-interrupt  */ 


Register.h.ah  =2; 
Register.h.bh  =0; 
Register. x.dx  =  0; 
int86(0xl0,  &Register, 

} 


/*  Set  Function  number  for  Cursor  position  */ 
/*  Screen  page  0  */ 
/*  Coordinates  of  upper  left  screen  corner  */ 
&Register);  /*  Call  BlOS-Video-interrupt  */ 


/*  PRINTCONFIG:  Output  the  PC  Configuration  */ 
/*  Input  :  none  */ 
/*  Output  :  none  */ 
/*  Info  :  the  configuration  output  dependent  on  the  PC-Type  */ 


/**★** ****************************************************************/ 


void  PrintConfig 0 

{ 

union  REGS  Register;  /*  Register-Variable  for  interrupt -Call  */ 

short  int  AT;  /*  the  PC  and  AT?  */ 


Cls();  /*  Clear  Screen  */ 

if  (PeekB(0xF000,  OxFFFE)  ==  OxFC)  AT  =  TRUE;  /*  Determine  if  the  */ 
else  AT  =  FALSE;  /*  PC  and  AT  */ 

printf ("CONFIG  (c)  1987  by  Michael  Tischer\n\n") ; 
printf ("Configuration  of  this  PC\n"); 

printf  (" - \n") ; 

printf ("PC-Type  :  "); 

switch (PeekB(0xF000,  OxFFFE))  /*  Determine  PC-Type  again  */ 

{ 


case  OxFF 
case  OxFE 
case  OxFC 
default 


printf ("PC\n") ; 
break; 

printf ("XT\n") ; 
break; 

printf ("AT\n") ; 
break; 

printf ("UnknownXn") ; 
break; 


/*  OxFF  a  normal  PC  */ 
/*  OxFE  an  XT  */ 
/*  OxFC  an  AT  */ 
/*  Code  unknown  */ 


} 

printf ("Processor  :  INTEL  80") ; 

if  (AT)  printf ("286\n") ;  /*  the  AT  has  an  80286,  */ 

else  printf ("88\n") ;  /*  PC  and  XT  have  an  8088  Processor  */ 

pr i nt  f ( " RAM-Memory  :  " )  ; 

int86(0xl2,  &Register,  &Register) ;  /*  Get  RAM  size  */ 

printf ("%d  KB\n", Register. x. ax) ;  /*  and  output  */ 

if  (AT)  /*  the  PC  an  AT?  */ 

{  /*  YES  */ 

Register.h.ah  =  0x88;  /*  Function  number  for  additional  RAM  */ 

int86(0xl5,  &Register,  &Register) ;  /*  Get  RAM  size  */ 

printf ("additional  RAM  :  %d  KB  beyond  lMB\n",  Register.x.ax) ; 


} 

int86(0xll,  fiRegister,  &Register) ;  /*  BlOS-Configuration-interrupt  */ 

printf ("Video  mode  after  Start  :  "); 
switch (Register.x.ax  &  48) 


{ 


case  0  :  printf ("undefinedXn") ; 
break; 

case  16  :  printf ("40*25  Character  Color-Card\n") ; 
break; 

case  32  :  printf ("80*25  Character  Color-Card\n") ; 
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break; 

case  48  :  prlntf ("80*25  Character  Mono-CardXn") ; 
break; 

} 

prlntf ("Disk  drives  ;  %d\n",  (Register. x. ax  »  6  &  3)  +  1); 

prlntf ("RS232-Card  :  %d\n",  Register .x. ax  »  9  &  0x03); 

prlntf ("Printer-Card  :  %d\n\n",  Register. x. ax  »  14); 

} 

/**********************  it*ic******  It*************************************/ 

/**  MAIN  PROGRAM  **/ 

/★*★***★**★***★**★* ***************************************^***********y 

void  malnO 
1 

PrintConfig 0 ;  /*  Output  the  Configuration  */ 

} 
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7.7  Accessing  the  Floppy  Disk  from  the  BIOS 

A  cassette  recorder  was  the  primary  form  of  mass  storage  in  the  early  days  of 
personal  computing.  However,  floppy  drives  soon  became  the  standard.  PCs  can 
control  a  maximum  of  four  disk  drives,  numbered  0  to  3.  DOS  designates  the  first 
two  units  as  drive  A  and  drive  B. 

Early  disk-based  PC  systems  used  only  one  side  of  disks  for  data  storage.  DOS 
Versions  1.1  and  later  store  data  on  both  sides  of  the  disk. 

Disk  structure 

Each  side  of  a  disk  consists  of  40  tracks  of  9  sectors  each.  Each  sector  has  a 
capacity  of  512  bytes.  The  tracks  are  numbered  from  0  to  39.  Track  0  is  located  on 
the  outer  edge  and  track  39  on  the  inner  edge  of  the  disk.  The  two  disk  sides  have 
designations  of  side  0  (front)  and  side  1  (back).  This  disk  has  a  total  storage 
capacity  of  360K. 

The  disk  drives  included  with  AT  computers  have  80  tracks  with  15  sectors  instead 
of  40  tracks  with  9  sectors.  An  AT  floppy  drive  can  store  up  to  1.2  megabytes  of 
data  per  disk.  Systems  with  a  1.2  megabyte  drive  can  read  both  1.2  meg  disks  as 
well  as  360K  disks. 

Note:  While  it’s  possible  to  write  360K  formatted  disks  using  an  AT  type 

1.2  megabyte  drive,  the  resulting  disks  are  not  always  readable  by  a 
standard  PC/XT  360K  drive. 

The  following  shows  the  structure  of  a  disk: 
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Track  1 
Track  2 
Track  3 


Sector  1 
Sector  2 


Structure  of  a  disk 

This  structure  is  based  on  DOS  specifications.  It’s  possible  to  program  the  disk 
controller  directly  or  use  the  various  BIOS  functions  to  alter  the  disk  structure. 
Some  methods  of  copy  protection  take  advantage  of  this  capability  to  arrange  the 
data  on  the  disk  in  such  a  way  that  DOS  cannot  use  the  data  directly. 

The  methods  of  transferring  data  to  or  from  the  disk  are  identical.  First  the 
read/write  head  moves  to  the  proper  track.  Since  the  disk  moves  constantly,  the 
sector  to  be  processed  eventually  passes  by  the  head,  allowing  data  transfer. 

BIOS  makes  some  functions  available  for  disk  access  at  the  lowest  level.  BIOS 
thinks  of  DASD  (Direct  Access  Storage  Device)  rather  than  disk  drives. 

A  total  of  six  BIOS  disk  functions  can  be  accessed  by  calling  interrupt  13H  and 
passing  the  function  number  to  the  AH  register. 

Function  0:  Reset  disk 

Function  0  resets  the  disk  drive.  The  reset  always  executes  automatically  during 
system  start,  but  should  also  occur  when  an  error  occurs  during  the  call  of  one  of 
these  six  functions.  Before  the  interrupt  call,  function  number  0  must  be  loaded 
into  the  AH  register.  After  the  execution  of  the  function  the  error  status  is  returned 
in  the  AH  register.  A  value  which  indicates  the  type  of  error  if  any,  is  returned  in 
the  AH  register  after  all  6  functions. 
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If  a  program  calls  the  reset  function  without  the  disk  drive  previously  reporting  an 
error,  error  code  1  (function  number  not  permitted)  may  be  returned  in  certain 
cases,  even  though  no  error  occurred.  For  this  reason,  the  function  should  be  called 
only  after  an  error,  and  not  after  every  disk  operation. 

Function  1:  Status 

Function  1  senses  disk  status  without  disk  access.  If  it  returns  a  value  of  0  as  a 
result,  no  error  occurred.  Another  value  represents  one  of  the  following  error  codes: 


OlH 

Function  number  not  permitted 

02H 

Address-marking  not  found 

03H 

Write  attempt  on  write  protected  disk 

04H 

Sector  address  not  found 

06H 

disk  changed 

OSH 

DMA-Overrun 

09H 

Data  transmission  beyond  segment  border 

lOH 

Read  error 

20H 

Disk  controller  error 

40H 

Track  not  found 

80H 

Time-Out  error,  drive  does  not  respond 

If  one  of  these  errors  appear,  the  disk  operation  just  completed  has  been  repeated 
several  times  following  a  reset.  Most  of  the  time  the  repeated  operation  succeeds 
without  an  error.  If  not,  the  current  program  in  memory  should  react  to  the  error 
condition  in  a  suitable  manner  and  display  an  error  message. 

Working  with  the  functions  presented  here,  a  time-out  error  can  occur  frequently 
after  a  read  operation.  It  usually  occurs  because  of  the  speed  decrease  required  to 
read  the  disk:  The  old  speed  cannot  be  resumed  immediately  after  reading. 

Function  2:  Read 

Function  2  reads  disk  data.  The  BIOS  must  know  the  location  from  which  you 
want  disk  data  read.  This  information  is  passed  in  the  DL,  DH,  CL  and  CH 
registers: 


DL 

Drive  number  (0  to  3) 

DH 

Disk  side  (always  0  for  single  sided  disks) 

0  =  Front  side 

1  =  Back  side 

CL 

First  sector  to  be  read  (1  to  9/1  to  15) 

CH 

Track  containing  sector  to  be  read 

299 


7.  The  BIOS 


PC  System  Programnung 


Up  to  9  sectors  (PC/XT  disk  drives)  or  15  sectors  (AT  disk  drives)  can  be  read 
using  one  function  call.  The  AL  register  specifies  this  number  of  sectors.  Since 
disk  drives  usually  store  data  belonging  together  in  sequential  sectors,  this  enables 
fast  data  access  (e.g.,  9  x  512  bytes  =  4.5K  in  one  disk  revolution). 

The  address  of  a  buffer  in  memory  must  be  passed  in  registo^  ES  and  BX  since  the 
data  transfer  area  has  no  fixed  location  in  RAM  in  which  it  can  reside.  The  ES 
registCT  accepts  the  segment  address  of  the  buffer  and  the  BX  register  accepts  the 
offset  address. 

The  function  returns  the  error  status  to  the  AH  regista,  and  the  numbo'  of  sectors 
read  in  the  AL  register.  In  addition  to  the  AH  register,  a  set  carry  flag  (carry  flag  = 
1)  signals  the  occurrence  of  an  error. 

Function  3:  Write 

Function  3  allows  write  access  to  the  disk.  It  accepts  arguments  similar  to  those 
used  in  function  2  above: 


DL 

Number  of  the  drive  (0  to  3) 

DH 

Disk  side  (always  0  for  single  sided  disks) 

0  =  Front  side 

1  =  Back  side 

CL 

First  sector  to  be  written  (1  to  9/1  to  15) 

CH 

Track  in  which  the  sector  to  be  written  is  located 

The  value  in  the  AL  register  indicates  the  number  of  sectors  to  be  written,  while 
the  ES  and  BX  registers  indicate  the  address  of  the  memory  area  from  which  the 
data  should  be  read.  The  function  passes  the  error  status  in  the  AH  register,  and  the 
number  of  sectors  written  in  the  AL  register.  The  carry  flag  has  the  same  meaning 
as  in  function  2. 

Function  4:  Verify  disk 

Function  4  tests  whether  data  is  transfmed  properly  to  and  from  the  disk.  The 
BIOS  bases  correct  data  transmission  on  a  cyclical  redundancy  check  (CRQ  value, 
instead  of  just  comparing  data  in  memory  with  data  on  disk.  Using  a  CRC 
involves  summing  the  value  of  each  individual  byte  in  a  sector  with  a  specific 
formula.  Since  most  disk  drives  work  well  and  have  excq)tional  reliability,  most 
programmers  ignore  this  function.  DOS  only  uses  this  function  to  test  data  that 
was  transmitted  to  a  disk  in  response  to  an  active  VERIFY  ON  flag. 
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The  registo*  setup  is  similar  to  functions  2  and  3  (see  above),  with  the  difference 
that  the  AH  register  must  contain  4.  Since  the  function  doesn't  need  a  buffer 
address,  t^  function  does  not  use  the  BX  and  the  ES  registos. 

Note:  This  function  only  works  properly  on  a  PC  or  an  XT:  ATs  may 

return  incorrect  results. 

Function  5:  Format 

The  last  function  of  intarupt  13H  allows  the  user  to  format  part  of  a  disk.  Disk 
formatting  (e.g.,  with  the  DOS  command  FORMAT)  is  a  requirement  since  disks 
used  by  the  PC  are  soft-sectored.  This  means  that  software,  not  hardware, 
determines  the  positioning  of  the  sectors  and  tracks  on  the  disk.  The  opiating 
system  must  install  the  tracks  and  sectors  on  the  disk  using  this  function.  Sectors 
don't  have  to  contain  512  bytes.  This  BIOS  function  lets  you  format  128,  256, 
512  or  1,024  bytes  per  sector.  However,  you  must  format  a  complete  track. 

The  function  number  (5)  must  be  passed  in  the  AH  register.  The  AL  register  is 
loaded  with  the  number  of  sectors  to  format  the  track  with.  This  number  can  be 
less  than  the  DOS  default  values  of  9  or  15.  The  number  of  the  track  to  be 
formatted  is  passed  in  the  CH  registo*.  This  track  number  must  be  a  value  from  0 
to  39  (PC/X'T)  or  from  0  to  79  (AT).  The  numbo'  of  the  disk  drive  is  passed  in  the 
DL  register  and  the  disk's  side  in  the  DH  register. 

Besides  this  information,  the  format  function  also  requires  a  field  containing 
formatting  char|eteristics,  which  is  also  needed  by  the  functions  for  reading, 
writing  and  verifying  a  sector.  Die  address  of  this  field  is  passed  in  the  ES  and  BX 
registCTS.  The  segm^t  address  is  loaded  in  the  ES  register  and  the  offset  address  in 
the  BX  register. 

This  table  contains  an  entry  consisting  of  four  bytes  for  every  sector  to  be 
formatted: 


ESSSDI 

Track  to  be  formatted 

Byte  2 

Disk  side  (always  0  for  single  sided  disks) 

0  =  Front  side 

1  =  Back  side 

Byte  3 

Number  of  sector 

Byte  4 

Number  of  bytes  in  this  sector 

0  =  128  bytes 

1  =  256  bytes 

2  =  512  bytes 

3  =  1024  bytes 

Even  though  the  function  already  possesses  the  number  of  the  track  to  be  formatted 
and  the  disk  side,  these  items  ^pear  hm  again  for  reasons  of  safety.  The  sectors 
are  placed  into  this  table  sequentially,  which  assigns  the  first  sector  the  logical 
numb^  1  and  the  second  sector  the  logical  numbo’  7. 
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While  the  logical  and  physical  numb^  of  the  sectors  usually  agree  in  a  disk  drive, 
it  makes  sense  in  a  hard  disk  to  change  the  logical  number  of  a  sector  instead  of  its 
physical  number.  The  hard  disk  of  the  XT  reduces  access  time  for  individual  sectors 
by  displacing  the  logical  sect(H*s  by  six  in  relation  to  the  physical  sectors. 

Also  the  number  of  bytes  which  a  sector  can  accommodate  does  not  have  to  be 
uniform,  since  each  sector  may  be  defined  in  the  table.  With  this  and  other 
parameters  of  the  table,  copy  protection  can  be  developed  based  on  formatting. 
Format-based  copy  protection  cannot  be  processed  by  the  q)erating  system. 

In  addition  to  information  such  as  the  disk  drive  and  sector  number  passed  to  the 
BIOS  functions  during  a  call,  the  BIOS  also  requires  a  series  of  other  items  to 
enable  some  disk  operations.  These  parameters  are  passed  in  the  device  parameter 
table.  Such  a  table  exists  in  the  ROM  BIOS,  but  you  can  install  your  own  in 
RAM.  The  address  of  the  new  device  parameter  table  must  be  placed  into  memory 
locations  0000:0078  to  0000:007B.  These  memory  locations  should  contain  the 
address  of  interrupt  lEH  (the  PC  doesn’t  use  this  interrupt). 

DOS  also  offers  the  option  of  providing  a  unique  device  parameter  table  which 
changes  some  values  of  this  table  from  the  BIOS  default,  accelerating  access  to  the 
diskdrives. 

The  table  itself  consists  of  1 1  bytes.  The  first  two  bytes  transfer  directly  to  the 
disk  controller.  They  indicate  the  step  time  and  the  DMA  mode.  The  step  time  is 
the  maximum  time  period  in  which  the  read/write  head  of  the  disk  drive  can  move 
from  one  track  to  another. 

The  second  byte  indicates  the  time  the  disk  drive  motor  can  continue  to  run  after  a 
disk  operation.  It  defaults  to  2  seconds  since  it  assumes  that  this  is  the  maximum 
amount  of  time  between  consecutive  disk  accesses.  Disk  access  speed  is  quicker  if 
the  disk  motor  has  already  achieved  operational  speed  and  does  not  have  to  be 
brought  up  to  speed  again.  The  value  in  this  memory  location  is  based  on  the  18 
unit  per  second  system  clock,  so  a  value  of  18  represents  running  time  of  about 
one  second. 
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The  value  in  byte  3  indicates  the  number  of  bytes  per  sector  for  a  write  or  read 
operation.  It  corresponds  to  the  values  for  formatting  a  sector,  so  it  normally 
contains  the  value  3  (512  bytes  pa*  sector).  If  you  want  to  write  or  read  sectors 
with  other  sector  sizes,  the  proper  value  must  be  entered  into  this  memory 
location. 

Byte  4  gives  the  maximum  number  of  sectors  per  track.  The  PC/XT  disk  drive 
defaults  to  the  value  9  in  this  location,  while  the  AT  defaults  to  the  value  IS 
decimal. 

Byte  S  of  the  table  contains  a  value  that  represents  the  amount  of  empty  space 
between  the  end  of  a  sector  and  the  start  of  the  following  sector.  This  space  relates 
to  the  time  BIOS  must  allow  to  elapse  until  the  next  sector  appears  under  the 
read/write  head  (not  units  of  length).  The  value  for  this  memory  location  defaults 
to  42. 

Byte  6  determines  the  data  transfer  length,  which  has  no  influence  on  data 
transmission  in  most  cases. 

Since  formatting  of  a  disk  occurs  through  the  magnetization  of  certain  areas,  the 
sizes  of  the  non-magnetic  spaces  between  sectors  must  be  determined.  Byte  7 
records  this,  and  these  spaces  must  be  larger  than  the  space  between  sectors  in  byte 
5  so  that  the  beginning  of  a  sector  can  be  recognized  properly. 

Byte  8  accepts  the  ASCII  code  of  the  character  which  fills  a  sector  during 
formatting.  The  BIOS  defaults  to  the  division  character  V  (ASCII  code  246). 

After  the  read/write  head  moves  from  one  track  to  another  it  requires  a  rest  period 
to  let  the  vibrations  connected  with  the  movement  fade  away.  Then  it  can  properly 
perform  any  disk  accesses  which  follow. 

This  rest  period  given  in  byte  9  of  the  table  defaults  to  multiples  of  1  millisecond. 
While  the  BIOS  grants  25  milliseconds  of  rest,  DOS  only  permits  15 
milliseconds. 

The  last  entry  of  the  table  in  byte  10  gives  the  time  duration  during  which  the  disk 
motor  achieves  operating  speed.  The  value  in  this  memory  location  defaults  to 
multiples  of  1/8  second.  Even  here  DOS  requires  more  from  the  read/write  head 
than  BIOS.  It  provides  only  a  1/4  second  waiting  period,  as  opposed  to  1/2  second 
for  BIOS. 
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High  density  disk  drives 

Part  of  the  introduction  of  the  AT  included  high  density  1.2  megabyte  disk  drives. 
To  ensure  compatibility  with  earlia*  disk  drives,  they  are  ct^ble  of  reading  and 
writing  320/3MK  disks  despite  the  increase  to  the  higher  capacity  of  1.2 
megabytes.  They  can  also  recognize  a  change  of  the  disk  media.  For  suppwt  of 
this  new  capabiUty,  AT  BIOS  contains  three  new  disk  functions  which  are  called 
through  interrupt  13H  like  previous  functitms. 

The  first  of  these  new  functions  determines  the  drive  type  in  use.  During  the 
function  call,  in  addition  to  function  number  ISH,  the  numl^  of  the  drive  (0  or  1, 
2  reserved  for  the  hard  disk)  must  be  passed  in  the  DL  register.  The  function 
returns  the  type  of  the  drive  in  the  AH  registo': 


o 

II 

1 

no  drive  available 

AH  =  1 

disk  drive  does  not  detect  disk  change 

AH  =  2 

disk  drive  does  detect  disk  change 

AH  =  3 

Hard  disk 

If  the  drive  detects  a  disk  change  it  can  be  sensed  with  the  help  of  function  16H. 
After  calling  this  function  by  passing  the  value  16H  to  the  AH  register  and  the 
number  of  the  drive  (0  or  1),  the  function  returns  a  number  to  the  AH  register 
which  tells  whether  the  disk  was  changed  since  the  last  disk  access.  If  this  register 
contains  the  value  6,  the  disk  was  changed.  The  value  0  indicates  that  no  change 
todc  place. 

The  last  new  function,  function  17H,  must  be  called  before  calling  the  formatting 
function  (function  number  5)  on  PCyAT  or  PS/2  machines  to  tell  the  controller 
how  it  should  fcnmat  the  disk.  It  should  format  the  disk  in  either  the  320/360K  or 
the  1.2  megabyte  format.  Besides  the  function  number  in  the  AH  registo*  and  the 
drive  number  in  the  DL  register,  a  code  must  be  passed  to  the  AL  register 
indicating  not  only  the  format  type,  but  also  the  type  of  disk  drive  in  use.  This 
code  has  the  following  meaning: 


1 

format  to  320/360K  on  a  320/360K-drive 

2 

format  to  320/360K  on  a  1.2  megabyte-drive 

3 

format  to  1.2  MByte  on  a  1.2  megabyte-drive 
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Demonstration  programs 

The  disk  monitor  in  this  section  combines  all  the  functions  you  have  read  about  so 
far.  The  monitor  versions,  written  in  BASIC,  Pascal  and  C,  all  have  the  same 
basic  structure.  Let's  examine  this  structure  before  looking  at  the  individual 
programs. 

The  beginning  of  each  program  initializes  variables,  configures  the  screen  and 
resets  the  disk  drives.  Next  the  input  loop  executes;  this  loop  is  the  center  point  of 
the  program.  It  displays  the  program  prompt  DISKMON>  and  then  waits  for  user 
input.  After  the  user  enters  input  and  presses  the  <Retum>  key,  the  program 
ensures  that  this  input  calls  an  executable  command.  If  the  input  is  illegal,  the 
program  displays  an  error  message  and  returns  to  the  program  prompt.  Legal  input 
calls  the  subroutine,  function  or  procedure  requested. 

All  three  programs  support  the  Help,  Format,  Get,  Fill,  Constants  and  End 
commands.  The  Fill  command  fills  a  sector  with  one  character.  The  End  command 
terminates  the  program.  There  is  no  Write  command  in  the  monitor's  command 
set.  This  is  because  the  amount  of  coding  required  to  create  a  window  for  editing 
the  512  bytes  of  a  sector  would  have  made  the  program  listings  too  long. 

All  disk  access  commands  ask  for  the  track  and  perhaps  the  sector  number  of  the 
disk,  but  not  the  disk  drive  number  or  the  disk  side  number.  The  program  defaults 
to  disk  drive  0  (drive  A:)  and  disk  side  0.  The  Constants  command  lets  you  change 
these  defaults  so  you  can  access  another  disk  drive  or  disk  side.  This  command  also 
specifies  the  format  parameter  needed  for  an  AT  (i.e.,  what  disk  format  should  be 
used). 

Like  all  other  user  input,  the  program  transfers  this  input  to  the  BIOS  instead  of 
the  program  itself.  This  disk  monitor  checks  the  BIOS's  reaction  to  the  input  The 
BIOS  returns  an  error  message  in  response  to  illogical  or  false  input.  Every  disk 
monitor  command  which  accesses  the  disk  drive  reads  the  error  status  of  the  disk 
drive  after  command  execution.  An  error  message  then  appears  on  the  screen  as 
needed 

Let's  take  a  close  look  at  the  monitor  commands: 

?  Entering  a  question  mark  (?)  at  the  program  prompt  displays  a  list  of 

the  available  commands. 

Get  This  overview  includes  a  Get  command  which  reads  and  displays  a 

sector  of  the  disk.  An  internal  buffer  stores  the  contents  of  this  sector 
after  input  and  displays  the  contents  on  the  screen.  Certain  control 
characters  such  as  carriage  returns  or  linefeed  are  shown  as  character 
strings  instead  of  as  ASCII  codes.  For  example,  <CR>  appears 
instead  of  an  actual  a  carriage  return,  and  <LF>  appears  instead  of  a 
linefeed.  While  reading  a  sector  the  program  assumes  that  the  sector 
has  the  standard  format  of  512  bytes. 
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Format  The  Format  command  formats  the  selected  sector  in  a  512-byte 
format.  Remember  that  a  360K  disk  can  have  a  maximum  of  9 
sectors  per  track  and  a  1.2  megabyte  disk  can  have  a  maximum  of  IS 
sectors  per  track.  You  can  assign  fewer  sectors,  but  you  must  specify 
at  least  one  sector. 


Reset  The  Reset  command  resets  the  disk  drives.  It  also  can  be  called  by 
various  commands  when  the  disk  drive  reports  an  error.  If  it's  called 
by  the  user  before  an  error  occurs,  this  can  cause  an  error  message. 
Most  disk  error  messages  cannot  cause  damage  to  the  drive. 

BASIC  listing:  DISKMONB.BAS 


'*  DISKMONB  *• 

'*  Task  ;  Diskmon  is  a  small  Diskette  monitor  based  *' 

'  *  on  the  BlOS-Interrupt  13 (h)  * ' 

:  MICHAEL  TISCHER  *' 

:  07/24/87  *• 

:  05/20/89  *• 

***********************  it*  ************************  **********  • 


100 
no 
120 
130 

140  •* 

150  '*  Author 
160  '*  developed  on 
170  '*  last  Update 
180 
190  • 

200  CLS  :  KEY  OFF 

210  PRINT  "WARNING:  This  Program  should  only  be  started  if  GWBASIC  was" 
220  PRINT  "started  from  the  DOS  level  with  <GWBASIC  /m:60000>." 

230  PRINT  :  PRINT"If  this  was  not  the  case,  please  input  <s>  for  Stop." 
240  PRINT  "Else  press  any  key  ..."; 

250  A$  =  INKEY$  :  IF  A$  *  "S"  THEN  END 
260  IF  A$  =  ""  THEN  250 

•Stores  Sectors  to  be  read  or  written 
•Formatting  data  (maximum  0-29  *  30  Words) 
•Initialize  Interrupt-Routine 
•Clear  Screen 
•Turn  off  Function  key  assignment 
•dark  characters  on  light  background  (invers) 
1987  by  Michael  Tischer  ?  =  Help  " 

•light  characters  on  dark  background 
•Lines  2  to  24  form  a  window 
•access  unit  0  (A)  first 
•access  the  first  Diskette  side 
•1.2  MB  Diskettes  in  1.2  MB  drive 
•Set  BlOS-Segment 
&HFC  THEN  AT%  =  -  1  ELSE  AT%  =  0  •test  if  AT 


270  DIM  SECTOR%[255] 

280  DIM  FD%[29] 

290  GOSUB  60000 
300  CLS 
310  KEY  OFF 
320  COLOR  0,7 
330  PRINT"  DISKMON  (c) 
340  COLOR  7,0 
350  VIEW  PRINT  2  TO  24 
360  DR%  =  0 
370  SIDE%  =  0 
380  FTYP%  =  3 
390  DEF  SEG  *  &HF000 
400  IF  PEEK(&HFFFE) 

410  DEF  SEG 

420  GOSUB  50000 

430  GOSUB  51000 

440  INPUT"DISK-MON>",E$ 


450  IF  E$  -  ""  THEN  440 
460  IF  E$  =  "?"  THEN  GOSUB  53000 
470  IF  E$  =  "r"  THEN  GOTO  420 
480  IF  E$  =  "s"  THEN  GOSUB  54000 

490  IF  E$  =  "f"  THEN  GOSUB  55000 

500  IF  E$  =  "g"  THEN  GOSUB  56000 

510  IF  E$  =  "c"  THEN  GOSUB  57000 

520  IF  E$  =  "e"  THEN  VIEW  PRINT  1  TO  24:  CLS 

GOTO  440 


•Set  BlOS-Segment  again 
•Execute  Reset 
Output  Error  message  if  necessary 
•User  input  proirqpt 
— >  repeat  input  prompt 
•Display  Help-Text 
• Reset 
•fill  a  Sector 
•format  a  Track 
•Read  Sector  and  display 
•Input  Constants 
END  •  End  Program 


•no  input 
GOTO  440 

GOTO  430 
GOTO  430 
GOTO  430 
GOTO  440 


530  PRINT"unknown  Command!" 

540  • 

50000  •  ****"^***************11******************************************  I 

50010  •*  Execute  Reset  of  all  Disk  drives  *' 

50020  •* - *• 

50030 
50040 
50050 


Input  :  none 

Output:  DST%  =  the  Diskette-Status 
Info  :  Z%  is  a  Dummy-Variable 
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50060 

50070 

50080 

50090 

50100 

50110 

50120 

51000 

51010 

51020 

51030 

51040 

51050 

51060 

51070 

51080 

51090 

51100 

51110 

51120 

51130 

51140 

51150 

51160 

51170 

51180 

51190 

51200 

51210 

53000 

53010 

53020 

53030 

53040 

53050 

53060 

53070 

53080 

53090 

53100 

53110 

53120 

53130 

53140 

53150 

53160 

53170 

53180 

53190 

54000 

54010 

54020 

54030 

54040 

54050 

54060 

54070 

54080 

54090 

54100 

54110 

54120 

54130 

54140 

54150 

54160 

54170 

54180 

54190 

54200 


********************** ******************************************* 


DST%  =  0  'Function  number  for  Reset 

INR%  “  &H13  'Call  BIOS-Diskette-Interrupt  13 (h> 

CALL  lA (INR%, DST%, Z%, Z%, Z%,  Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%) 

RETURN  'back  to  caller 

I *********************************★**********************★******' 

' *  Output  Error  Message  based  on  the  Diskette-Status  * ' 


'*  Input  :  DST%  =  Status  of  the  last  Diskette  operation  *' 

'*  Output:  none  *' 

• ***************************************** ********************** • 

IF  DST%  *  0  THEN  RETURN  '0  =  everything  o.k. 

PRINT  "ERROR: 

IF  DST%  -  &H1  THEN  PRINT"Function  number  not  allowed  "  :  GOTO  50000 
IF  DST%  =  &H2  THEN  PRINT"Address-Marking  not  found"  :  GOTO  50000 

IF  DST%  =  &H3  THEN  PRINT"Write  attempt  on  protected  Disk"  :  GOTO  50000 

IF  DST%  =  &H4  THEN  PRINT"Sector  not  found"  :  GOTO  50000 

IF  DST%  *  &H6  THEN  PRINT"Diskette  changed"  :  GOTO  50000 

IF  DST%  =  &H8  THEN  PRINT"DMA  Overrun"  :  GOTO  50000 

IF  DST%  =  &H9  THEN  PRINT"Data  transmission  beyond  segment  border"  :  GOTO  50000 

IF  DST%  =  &H10  THEN  PRINT"Read  Error"  :  GOTO  50000 

IF  DST%  =  &H20  THEN  PRINT"Error  of  Disk-Controller"  :  GOTO  50000 

IF  DST%  =  &H40  THEN  PRINT"Track  not  found"  :  GOTO  50000 

IF  DST%  =  &H80  THEN  PRINT"Time  Out  Error"  :  GOTO  50000 

PRINT"Error  ";DST%;"  unknown"  :  GOTO  50000 

*********  It******************************************************* 

'*  Display  Help-Text  on  the  screen  *' 


' *  Input  :  none  * 

'*  Output:  none  * 


PRINT 

PRINT"C  OMMAND  OVERVIEW" 

PRINT" - “ 

PRINT"e  =  End" 

PRINT"g  =  Get  (Read)" 

PRINT"s  =  Sector  fill" 

PRINT"r  =  Reset" 

PRINT" f  =  Format" 

PRINT" c  =  Constants" 

PRINT"?  =  Help" 

PRINT 

RETURN  'back  to  caller 


'*  Fill  a  Sector  * 


'*  Input  :  DR%  =  the  Number  of  the  unit  addressed  * 
'*  SIDE%  =  the  number  of  the  Disk  side  addressed  * 
'*  Output:  DST%  =  the  Diskette  status  * 
•*  Info  :  Z%  is  a  Dummy-Variable  * 

I ***★★★★★*****★***************************★★******★*★★***★★★★★** 


INPUT  "Track  :  ",TRACK%  'Track  in  which  the  Sector  is  located 
INPUT  "Sector  :  ",SECTOR%  'Sector  to  be  filled 

INPUT  "Character:  ",Z$  'Fill  Character 

IF  Z$  =  ""  THEN  Z$  =  CHR$(0) 

FOR  1%  “  0  TO  511  :  POKE  VARPTR (SECTOR% [0] > +1%, ASC (Z$)  :  NEXT 
DST%  =  3  'Function  number  for  writing 

INR%  =  &H13  'Call  BIOS-Diskette-Interrupt  13(h) 

NUM%  »  1  'Number  of  Sectors 

OFSLO%  =  0  :  OFSHI%  »  0  'initialize  Variables 

SEG%  “  -1  'Use  BASIC  DS  for  ES 

NUM%  =  1  'Number  of  Sectors  to  be  read 

OFSLO%  »  VARPTR (SECTOR%[0 I)  AND  255  'LO  &  HI-Byte  of  the  Offset 
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54210 

54220 

54230 

54240 

55000 

55010 

55020 

55030 

55040 

55050 

55060 

55070 

55080 

55090 

55100 

55110 

55120 

55130 

55140 

55150 

55160 

55170 

55180 

55190 

55200 

55210 

55220 

55230 

55240 

55250 

55260 

55270 

55280 

55290 

55300 

55310 

55320 

56000 

56010 

56020 

56030 

56040 

56050 

56060 

56070 

56080 

56090 

56100 

56110 

56120 

56130 

56140 

56150 

56160 

56170 

56180 

56190 

56200 

56210 

56220 

56230 

56240 

56250 

56260 

56270 

56280 

56290 

56300 

56310 

56320 


OFSHI%  =  INT(VARPTR(SECTOR%[0] )  /  256) 'address  of  Var  SECTOR%[0] 

CALL  lA (INR%, DST%, NUM%, 0FSHI%, 0FSL0% , TRACK% , SECT0R%, SIDE%, DR%,  2%, Z%, SEG%, Z%) 
RETURN  'back  to  caller 


*★*★★★** 

Format 


***★★★* 1 
a  Track 


■k  *  It  It  -k  it  It  -k  -k  If 


kkkkkkkkkkk 


***********  I 


Input  :  DR%  =  the  number  of  the  unit 

SIDE%  =  the  number  of  the  disk  side 
FTYP%  *  Type  of  Disk  drive 

AT%  “  -1  if  conputer  is  an  AT,  otherwise  0 
DST%  “  the  Diskette  status 
Z%  is  a  Dummy- Variable 


Output : 
Info  : 
******** 


*************************** 


^******************* 


IF  NOT(AT%)  THEN  55150  'if  not  AT,  then  no  format  fitting 
FKT%  =  6H17  'Set  Function  number  for  DASD  Type 
INR%  =  &H13  'Call  BIOS-Diskette-Interrupt  13(h) 
CALL  lA (INR%, FKT%, FTYP%, Z%, Z%, Z%, Z%, Z%, DR%,  Z%, Z%, Z%, Z%) 

INPUT  "Track  :  ",TRACK%  'Number  of  Track  to  be  formatted 
INPUT  "Number  Sectors:  ",NUM%  'Number  of  Sectors  to  be  installed 
IF  NUM%  >  15  THEN  55160  'maximum  of  15  Sectors  can  be  installed 


FOR  1%  =  0  TO  NUM%-1 
POKE  VARPTR(FD%[0])+I%*4,TRACK% 
POKE  VARPTR(FD%[0])+I%*4+1,SIDE% 
POKE  VARPTR(FD%[0])+I%*4+2,I%+1 
POKE  VARPTR(FD%[0])+I%*4t3,2 
NEXT 
DST%  =  5 
INR%  =  &H13 
OFSLO%  =  0 
SEG%  = 

OFSLO% 

0FSHI% 


'one  entry  for  every  Sector 
'Enter  number  of  Track 
•Enter  number  of  side 
'Enter  Sector  number 
'Format  Sector  with  512  Bytes 
'Process  Entry  for  next  Sector 
•Function  number  for  Formatting 
Call  BIOS-Diskette-Interrupt  13  (h) 
•initialize  Variables 
-1  'Use  BASIC  DS  for  ES 

=  VARPTR(FD%[OJ )  AND  255  'LO  and  HI-Byte  of  Offset 

=  INT(VARPTR(FD%[0])  /  256)  'address  of  Var.  FD%[0] 

CALL  lA (INR%, DST%, NUM%, OFSHI%, OFSLO%,  TRACK%, Z%, SIDE%, DR%,  Z%, Z%, SEG%, Z%) 
RETURN  'back  to  caller 


OFSHI% 


read  a  Sector  and  display 


Input  :  DR%  =  the  Number  of  the  drive  to  be  accessed 
SIDE%  =  the  number  of  the  Diskette  side 
Output:  DST%  =  the  Diskette  status 
Info  :  Z%  is  a  Dummy-Variable 


*********** 


**************** 


INPUT  "Track  :  ",TRACK% 
INPUT  "Sector:  ",SECTOR% 
DST%  =  2 

&H13 
1 

0  :  OFSHI%  =  0 

-1 


INR% 

NUM% 

OFSLO% 

SEG% 

OFSLO% 

OFSHI% 


Track  in  which  the  Sector  is  located 
'the  Sector  to  be  filled 
•Function  number  for  reading 
•Call  BIOS-Diskette-Interrupt  13 (h) 

•Read  a  Sector 
•Create  Variables 
•Use  BASIC  DS  for  ES 
VARPTR(SECTOR%[0])  AND  255  'LO  and  HI-Byte  of  Offset 
INT(VARPTR(SECTOR%[0] )  /  256) 'addr  of  the  Var  SECTOR%[0] 

CALL  lA (INR%, DST%, NUM%,  OFSHI%, OFSLO%, TRACK%, SECTOR%, SIDE%,  DR%,  Z%, Z%, SEG%, Z%) 
IF  DST%  <>  0  THEN  RETURN  'on  error  do  not  output  data 

PRINT  STRINGS (80, "-") ; 

FOR  1%  =  0  TO  511  'process  all  Bytes  of  the  Sector  read 

Z%  =  PEEK(VARPTR(SECTOR%[0])  +  1%)  'get  a  Byte  from  the  Sector 

IF  Z%  =  0  THEN  PRINT  "<NUL>";  :  GOTO  56350 

IF  Z%  =  7  THEN  PRINT  "<BEL>";  :  GOTO  56350 

IF  (Z%  =  8)  OR  (Z%  =  29)  THEN  PRINT  "<BS>";  :  GOTO  56350 

IF  Z%  =  9  THEN  PRINT  "<TAB>";  :  GOTO  56350 

:  GOTO  56350 
:  GOTO  56350 
:  GOTO  56350 
:  GOTO  56350 
GOTO  56350 
GOTO  56350 


IF  Z%  =  10  THEN  PRINT  "<LF>"; 

IF  Z%  =  11  THEN  PRINT  "<H0M>"; 

IF  Z%  =  12  THEN  PRINT  "<FF>"; 

IF  Z%  =  13  THEN  PRINT  "<CR>"; 

IF  Z%  =  27  THEN  PRINT  "<ESC>"; 

IF  Z%  =  30  THEN  PRINT  "<CUP>"; 
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56330 

56340 

56350 

56360 

56370 

56380 

56390 

57000 

57010 

57020 

57030 

57040 

57050 

57060 

57070 

57080 

57090 

57100 

57110 

57120 

57130 

57140 

57150 

57160 

57170 

60000 

60010 

60020 

60030 

60040 

60050 

60060 

60070 

60080 

60090 

60100 

60110 

60120 

60130 

60140 

60150 

60160 

60170 

60180 

60190 

60200 

60210 

60220 

60230 


IF  Z%  «  31  THEN  PRINT  “<CDN>";  :  GOTO  56350 

PRINT  CHR$(Z%);  'output  Byte  as  ASCII  character 

NEXT  'output  next  Byte 

PRINT 

PRINT  STRINGS (80,"-"); 

RETURN  'back  to  caller 

I **************************************************************** 

'*  Input  Constants  (Unit  number,  Diskette  side,  etc.)  *' 


'*  Input  :  AT%  *  -1  if  computer  is  an  AT,  else  0  *' 

'*  Output:  DR%  *  Number  of  unit  to  be  accessed  *' 

'*  SIDE%  »  Number  of  disk,  side  *' 

FTYP%  -  Type  of  Disk  drive  *' 

I ***♦***************************************************★*******' 

INPUT  "Unit-Number  (0-3)  :  ",DR% 

INPUT  "Diskette  side  (0  or  1):  ",SIDE% 

IF  N0T(AT%)  THEN  RETURN  'Diskette  format  only  for  AT 

PRINT" Formatting  Parameter:" 

PRINT"  1  -  320/360  KB  diskette  in  320/360  KB  Drive" 

PRINT"  2  =  320/360  KB  diskette  in  1.2  MB  Drive" 

INPUT"  3  =  1.2  MB  diskette  in  1.2  MB  Drive  —  Please  input:  ",FTYP% 
RETURN  'back  to  caller 

I****************************************************************' 

'*  initialize  the  Routine  for  Interrupt  call  *' 


'*  Input  :  none 

'*  Output:  lA  is  the  Start  address  of  the  Interrupt-Routine 


************* 


IA=6p000!  'Start  address  of  the  Routine  in  the  BASIC-Segment 

DEF  SEG  'Set  BASIC-Segment 

RESTORE  60130 

FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'Poke  Routine 
RETURN  'back  to  caller 

DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 

DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 

DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

DATA  28,136,  36,139,118,  26,136,  4,139,118,  24, 136,  60, 139, 118 

DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 


Structurally  this  program  resembles  the  other  BASIC  programs  which  have  been 
presented.  The  main  program  with  the  input  loop  is  in  lines  300  to  540.  Then 
follow  the  individual  commands  of  DISKMON  which  exist  as  subroutines  between 
lines  50000  and  57170.  The  subroutine  for  initializing  the  interrupt  call  starts  at 
line  60000  (the  program  uses  this  interrupt  frequently). 


The  use  of  a  BASIC  variable  as  a  buffer  for  the  reading  and  wpting  of  data  is 
somewhat  complicated  in  this  program.  The  program  dimensions  an  integer  array 
with  elements  from  0  to  255.  Since  every  element  in  this  array  requires  2  bytes 
(for  integer),  the  program  allocates  512  bytes  for  a  buffer.  The  problem  arises  from 
the  BASIC  interpreter's  garbage  collection  routine.  When  it  removes  data,  which  is 
no  longer  needed,  from  the  variable  storage  area,  it  also  moves  the  data  buffer.  The 
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address  of  this  buff^  which  was  supposed  to  be  passed  to  BIOS  is  no  longer  valid. 
OthCT  data  aie  now  stored  there. 

During  a  write  operation  this  wouldn’t  be  very  bad,  since  only  false  data  would  be 
written  to  the  disk.  During  a  read  operation  this  could  lead  to  a  crash  of  the  BASIC 
interpreter,  since  variable  memory  could  be  destroyed.  To  prevent  this,  establish 
the  address  of  the  buffer  variable  immediately  before  the  BIOS  function  call.  Also, 
make  sure  that  the  variables  which  accept  this  address  are  constantly  available.  For 
this  reason  DISKMON  initializes  the  two  variables  with  0  before  storing  the 
buffer  address  in  them.  This  offset  address  must  receive  the  segment  address  of  the 
current  BIOS  function  in  the  ES  register.  Since  the  BASIC  data  segment  contains 
the  buffer  address,  the  contents  of  the  Data  segment  register  DS  must  be  passed  to 
ES.  This  is  done  by  passing  the  value  -1  for  ES  which  causes  the  interrupt 
function  to  copy  the  contents  of  the  DS  registers  to  ES. 

Pascal  listing:  DISKMONP.PAS 


^ *★**★*★***★★*★******★********«**** ************ ★★****★* ★*★**★*★★★} 


* 

DISKMONP 

*} 

* 

* 

* 

* _ 

Task 

;  DISKMON  is  a  small  disk  monitor  based  on 
the  functions  of  the  BIOS  diskette 
interrupt  13 (h) 

M 

*} 

_ *  1 

* 

Author 

:  MICHAEL  TISCHER 

* 

developed  on 

:  7/9/87 

*} 

* 

last  update 

:  5/19/89 

*} 

^ *********************************************************** **********^ 


program  DISKMC»I; 


Uses  Crt,  Dos; 


adds  Crt  and  Dos  features  } 


type  BufferTyp  =  array  [1..1]  of  char; 

ForroatTyp  *  record  {  BIOS  requires  this  information  for  } 

Track,  {  every  sector  of  } 

Side,  {  a  track  to  be  formatted  } 

Sector, 

Length  :  byte; 
end; 


var  ErrCode 
Command 
FTyp, 
DriveNum, 
Side 
Dummy 
AT 


:  byte; 

:  string [1]; 


;  integer; 

:  integer; 
:  boolean; 


{  Error  status  after  diskette  operation  } 
{  Command  input  by  the  user  } 
{  Diskette  type  for  formatting  function  } 
{  Number  of  current  drive  } 
{  Number  of  the  current  diskette  side  } 
{  Dunit^  variable  } 
{  is  the  canputer  an  AT?  } 


I  *********************************************************************  j 

{*  RESETDISK:  Reset  for  all  attached  disk  drives  *} 

{*  Input  :  none  *} 

{*  Output  :  error  status  *} 

I  *********************************************************************  j 


function  ResetDisk  :  integer; 
var  Regs  :  Registers; 
begin 

Regs. ah  :=  0; 


{  Register  variable  for  interrupt  call  } 
{  Function  number  for  reset  is  0  } 
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intr($13,  Regs);  {  Call  BIOS  disk  interrupt  } 

ResetDisk  :•»  Regs. ah;  {  Read  error  status  } 

end; 


I ★★**★★★★★**★*★***★★★★**★★****★★★*★**★★★★***★★★★*****★*******★*★**★*** } 

GETDISKSTATUS:  reads  the  error  status  *} 
{*  Input  :  none  *} 
{*  Output  :  the  error  status  *} 
^ ***★*★★★**★★★★★*★★*★★**★★★***★★*★★★★****★******★★★★★★***★★★**********} 


function  GetDiskStatus  :  integer; 

var  Regs  :  Registers;  {  Register  variable  for  interrupt  call  } 


begin 

Regs. ah  :=  1; 
intr($13,  Regs)  ; 
GetDiskStatus  :«  Regs. ah; 
end; 


Function  number  for  error  status  is  1  } 
{  Call  BIOS  disk  interrupt  } 
{  Read  error  status  } 


l**************************************************^ 

{*  READSECTORS:  read  a  certain  number  of  sectors 
{*  Input  :  see  below 
{*  Output  :  error  status 


****************** I 
*} 
M 
M 


function  ReadSectors (DriveNum, 
Side, 
Track, 
Sector, 
Number, 
SegAdr, 


{  Disk  drive  for  reading  } 
{  Side  or  read/write  head  number  } 
{  track  to  be  read  } 
{  The  first  sector  to  be  read  } 
{  Number  of  sectors  to  be  read  } 
{  Segment  address  of  the  buffer  } 


OfsAdr  :  integer;  {  Offset  address  of  the  buffer  } 
var  NumRead  :  integer)  :  integer; 


var  Regs  :  Registers; 


Register  variable  for  interrupt  call  } 


begin 

Regs. ah  :=  2; 

Regs.al  :=  Number; 
Regs.dh  :=  Side; 

Regs.dl  DriveNum; 

Regs.ch  :=  Track; 

Regs. cl  Sector; 

Regs.es  :=  SegAdr; 
Regs.bx  :=  OfsAdr; 
intr($13,  Regs) ; 

NumRead  Regs.al; 

ReadSectors  :=  Regs. ah; 
end; 


{  Function  number  for  reading  is  2  } 
{  Set  number  of  sectors  for  reading  } 
{  Set  side  number  } 
{  Set  drive  number  } 
{  Set  track  number  } 
{  Set  sector  number  } 
{  Set  buffer  address  } 

{  Call  BIOS  disk  interrupt  } 
{  Number  of  sectors  read  } 
{  Read  error  status  } 


^ *****★***★******************«********★★★★★*★★****★★*****★***★****★**★ j 

{*  WRITESECTORS :  Write  a  certain  number  of  sectors  *} 

{*  Input  :  see  below  *} 

{*  Output  :  error  status  *} 

{ ********************************************************************* j 


function  WriteSectors (DriveNum, 
Side, 
Track, 
Sector, 
Number, 
SegAdr, 
OfsAdr  : 


{  Disk  drive  ) 
{  Side  or  read/write  head  } 
(  Track  to  be  written  } 
(  First  sector  to  be  written  } 
{  Number  of  sectors  to  be  written  } 
{  Segment  address  of  the  buffer  } 
integer; {  Offset  address  of  the  buffer  } 


var  NumWritten  :  integer)  ;  integer; 


var  Regs  :  Registers;  {  Register  variable  for  interrupt  call  } 

begin 

Regs. ah  ;=  3;  {  Function  number  for  writing  is  3  } 
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Regs. a 1  :=  Number; 
Regs.dh  Side; 

Regs.dl  :*  DriveNum; 
Regs.ch  Track; 

Regs .cl  : =  Sector; 
Regs.es  :*  SegAdr; 
Regs.bx  :»  OfsAdr; 
intr($13,  Regs); 
NumWritten  :»  Regs.al; 
WriteSectors  :=  Regs. ah; 
end; 


1  Set  number  of  sectors  to  be  read  } 
{  Set  side  number  ) 
{  Set  drive  number  } 
{  Set  track  number  } 
{  Set  sector  number  } 
{  Set  buffer  address  } 

{  Call  BIOS  disk  interrupt  } 
{  Number  of  sectors  written  } 
(  Read  error  status  } 

V 

***************** *★***★★* *★*★****★*} 


{*  SETDASD:  must  be  called  for  an  AT  before  formatting  to  indicate  *) 


{*  if  it  should  be  formatted  with  360  KB  *} 
{*  or  with  1.2  MB  *} 
{*  Input  :  see  below  *} 
{*  Output  :  none  -  *1 


{*★**★*★**************★*******************★**★*★*★★**★★★*★★★**★*★*★★**} 


procedure  SetDasd (DiskFormat  :  integer) ; 

var  Regs  :  Registers;  {  Register  variable  for  interrupt  call  } 

begin 

Regs. ah  :=  $17;  {  Function  number  } 

Regs.al  :=  DiskFormat;  C  Format  } 

^  Regs.dl  :=  DriveNum;  {  Drive  number  } 

intr($13,  Regs);  {  Call  BIOS  disk  interrupt  ) 

end; 


{*  FORMATTRACK:  formats  a  track  *} 
{*  Input  :  see  below  *} 
{*  Output  :  the  error  status  *} 


function  Format Track (DriveNum, 
Side, 
Track, 
Number, 
Bytes 


{  Number  of  the  disk  drive  } 
{  the  side  or  head  number  } 
{  Track  to  be  formatted  } 
{  Number  of  sectors  in  this  track  } 
integer)  ;  integer; 


var  Regs  :  Registers;  {  Register  variable  for  interrupt  call  } 

DataField  :  array  [1..15]  of  FormatTyp;  {  maximum  15  sectors  ) 
LoopCnt  :  integer;  {  Loop  counter  } 


begin 

for  LoopCnt  :=  1  to  Number  do 
begin 

DataField  [LoopCnt  ]. Track 
DataField [LoopCnt] .Side  :« 
DataField [LoopCnt] .Sector  i- 
DataField [LoopCnt] .Length 
end; 

Regs. ah  :=  5; 

Regs.al  :=  Number; 

Regs.es  seg  (DataField [1] )  ; 

Regs.bx  :=  ofs(DataField[l] ) ; 
Regs.dh  :=  Side; 

Regs.dl  :=  DriveNum; 

Regs.ch  :=  Track; 
intr($13,  Regs) ; 

Format Track  :*  Regs. ah; 
end; 


{  Create  sector  descriptor  ] 

=•  Track;  {  Number  of  the  track  } 
Side;  {  Diskette  side  } 
'  LoopCnt;  {  Number  of  the  sector  } 
-  Bytes; {  Number  of  bytes  in  the  sector  ) 


{  Function  number.  Number  } 
{  Address  of  the  data  field  in  } 
{  registers  ES  and  BX  } 
{  Side  number  } 
{  Drive  unit  } 
{  Set  track  number  } 
[  Call  BIOS  disk  interrupt  } 
{  Read  error  status  } 


{*************★*****************★************★****★****★**★***★★*★**★*} 
{*  WRITEERROR:  Output  error  message  according  to  error  value  *} 

{*  Input  :  the  error  number  «  *} 

{*  Output  :  none  *} 


( 
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I  *********************************** **********************************} 

procedure  WriteError  (ErrorNumber  :  integer) ; 


begin 

case  ErrorNumber  of 

$00 

; 

$01 

writeln ( ' ERROR: 

$02 

writeln ('ERROR: 

$03 

writeln ('ERROR: 

$04 

writeln  ( 'EEIROR: 

$06 

writeln ('ERROR: 

$08 

writeln ( ' ERROR: 

$09 

writeln ('ERROR: 

$10 

writeln ('ERROR: 

$20 

writeln ('ERROR: 

$40 

writeln ('ERROR: 

$80 

writeln ('ERROR: 

else 

writeln ('ERROR: 

end; 

if  (ErrorNumber  o  0) 
end; 


{  0  means  no  error  } 

Invalid  function  number'); 

Address  marking  not  found'); 

Write  attempt  on  protected  disk  * ) ; 

Sector  not  found'); 

Diskette  changed'); 

DMA  overrun ' ) ; 

Data  transmission  beyond  segment  border'); 

Read  error ' ) ; 

Disk  controller  error'); 

Track  not  found ' ) ; 

Time  out  error ' ) ; 

Error  ' , ErrorNumber, '  unknown' ) ; 

then  ErrorNumber: =ResetDisk;  {  Reset  performed  } 


(*  CONSTANTS:  Input  of  the  two  constants  and  *} 
{*  diskette  side  or  head  number,  as  well  as  diskette  *} 
1*  type  for  AT  *} 
{*  Input  :  none  *} 
{*  Output  :  none  *} 


I  ********************************* *******t^ **************************** ^ 


procedure  Constants; 
begin 

write ( 'Unit-Number  (0-3)  :  '); 

readln (DriveNum) ;  {  Read  unit  number  } 

write ( 'Diskette  side  (0  or  1) :  '); 

readln (Side) ;  {  Read  head  number  ) 

if  AT  then  (  only  for  AT  } 

begin 

writeln ( ' Format-Parameter: ' ) ; 

writelnC  1  =  320/360-KB-Diskette  in  320/360-KB  drive'); 
writeln ('  2  =  320/360-KB-Diskette  in  1.2-MB  drive'); 

write ('  3  =  1.2-MB-Diskette  in  1.2-MB-drive  —  Please  input:  '), 

readln (FTyp) 
end; 
end; 


I  ********************************************************************* j 

{*  HELP:  Display  help  text  on  the  screen  *} 

{*  Input  :  none 

{*  Output  ;  none  *} 

^*********************************************************************1 
procedure  Help; 
begin 

writeln  (#13#10'C  OMMAND  OVERVIEW'); 

writeln  (' - •) ; 

writeln ('e  =  End'); 
writeln ( ' g  =  Get  (Read) ' ) ; 
writeln ('s  =  Sector  fill'); 
writeln ( ' r  =  Reset ' ) ; 
writelnCf  =  Format'); 
writeln ( ' c  =  Constants ' ) ; 
writelnC?  »  Help'#13#10)  ; 
end; 


I  **********  ************************************************* **********  j 

{*  READSEC:  Read  a  diskette  sector  and  display  it  on  the  screen  *} 
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{*  Input  :  none  *} 

{*  Output  :  none  *} 

I  *************************** ****************************************** I 


procedure  READSEC; 


var  DataBuffer  :  array  [1..512]  of  char;  {  the  characters  read  } 

Track,  {  the  track  from  which  to  read  } 

Sector  :  integer;  {  Sector  to  be  read  } 


begin 

write  ('Track  :  '); 

readln (Track) ;  {  Read  track  from  keyboard  } 

write ( 'Sector:  '); 

readln (Sector) ;  {  Read  sector  frcxn  the  keyboard  } 

ErrCode  :=  ReadSectors (DriveNum,  Side,  Track,  Sector,  1, 

seg (DataBuffer) ,  of s (DataBuffer) ,  Dummy) ; 
if  (ErrCode  =  0)  then  {  Error  occurred  during  reading?  } 

begin 

write  ( ' - ' 

. - .); 

for  Dummy :=1  to  512  do  {  output  the  512  characters  } 

begin 

case  DataBuffer [Dummy]  of 

#00  :  write (' <NUL> ') ;  {  treat  control  characters  separately  ) 

#07  :  write (' <BEL> ') ; 

#08  :  write ( '<BS>' ) ; 

#09  :  write (' <TAB> ') ; 

#10  :  write (' <LF> ') ; 

#13  :  write ( '<CR>' ) ; 

#27  :  write ( '<ESC>' ) ; 

else  write (DataBuffer [Dummy] ) ;  {  output  normal  character  } 

end; 
end; 

write(#13#10' - '  + 

. - .); 

end 

else  Wr iteErr or (ErrCode) ;  {  output  error  message  } 

end; 


(*  FORMATIT:  format  a  certain  number  of  sectors  of  a  *) 
{*  track  with  512  bytes  each  *} 
{*  Input  :  none  *} 
{*  Output  :  none  *} 


^ *********************************************************************) 

procedure  Format It; 

var  Track, 

Sector  :  integer; 

begin 

write ('Track  :  '); 
readln (Track) ;  (  Read  number  of  tracks  from  keyboard  ) 

write (' Sector:  '); 

readln (Sector) ;  {  Read  number  of  sectors  from  the  keyboard  } 

if  AT  then  SetDasd (FTyp) ;  1  if  AT  then  diskette  type  } 

WriteError (FormatTrack (DriveNum,  Side,  Track,  Sector,  2) ) ; 
end; 


{  Track  to  be  formatted  } 
{  Number  of  sectors  } 


(*********************************************************************} 
{*  FILLSECTOR:  Fill  a  sector  with  a  character  *} 

{*  Input  :  none  *) 

(*  Output  :  none  *} 

{******* ******************** ****************************************** I 

procedure  FillSector; 

var  DataBuffer  :  array  [1..512]  of  char;  {  Content  of  sector  to  fill  } 


314 


Abacus 


7.7  Accessing  the  Floppy  Disk  from  the  BIOS 


LoopCnt , 

Track, 

Sector  :  integer; 
FillChar  :  char; 


1  Loop  counter  } 
Track  in  which  the  sector  is  located  } 
{  Number  of  sector  to  be  filled  } 
{  the  fill  character  } 


begin 

write ( ' Track  :  ' ) ; 

readln (Track) ; 
write ( ' Sector  ;  * ) ; 

readln (Sector) ; 
write ( ' Character :  * ) ; 
readln (Fi 1 IChar )  ; 
for  LoopCnt  1  to  512  do 

DataBuffer [LoopCnt]  :»  FillChar;  (  Fill  buffer  with  characters  } 

WriteError (WriteSectors (DriveNum,  Side,  Track,  Sector,  1, 

seg (DataBuffer) ,  ofs (DataBuffer) ,  Dummy) ) ; 

end; 


{  Read  track  frcxn  keyboard  } 
{  Read  sector  frcrni  keyboard  } 
{  Read  the  fill  character  from  the  keyboard  } 


■k-k-k-k-k-k-k-ifk-k-k 


MAIN  PROGRAM 
*★★*★*★*★***★**★★*★★**★< 


kkkkkkkkkkkkk I 


begin 

clrscr; 

textbackground (7)  ; 
text color (0) ; 
writelnC  DISKMON: 


(c) 


1987  by  Michael  Tischer 
?  =  Help 


textbackground (0)  ; 
text color (7) ; 
window  (1,  2,  80,  25); 

DriveNum  :=  0; 

Side  :=  0; 

FTyp  :=  3; 

if  mem[$F000:$FFFE]  =  SFC  then  AT 
else  AT 

WriteError (ResetDisk) ; 
repeat 
repeat 

write  (•DISKMON>'); 
readln (Command) ; 
until  (Command  <>  *'); 
case  (Command  [1])  of 
:  Help; 

•r'  :  WriteError (ResetDisk) ; 

•s'  :  Fi 11 Sector ; 

'f  :  Format  It; 

•g*  :  READSEC; 

'c':  Constants; 
else  if  Command  <>  'e' 
end; 

until  (Command  =  'e'); 
end. 


[  Clear  screen  } 
[  light  background  } 
{  dark  characters  } 
‘+  {  Headline  } 

); 

1  dark  background  } 
{  light  text  } 

{  only  first  line  does  not  belong  to  window  } 
{  Indicate  unit  0  as  constant  } 
{  Side  0  as  constant  } 
{  1.2  MB  diskette  in  1.2  MB  unit  } 
true  {  test  if  AT  or  } 

false;  {  PC  or  XT  } 

(  perform  Reset  } 


{  output  prompt  } 
{  Read  command  from  keyboard  } 


{?  display  help  text  } 
[r  perform  reset  } 
(s  fill  a  sector  } 
[f  format  a  track  } 
(g  read  a  sector  } 
{c  input  constants  } 
then  writeln (' unknown  command'); 


(e  end  program  } 


The  DISKMON  in  Pascal  and  the  following  version  in  C  strongly  resemble  each 
other.  Both  have  the  input  loop  inside  the  main  program  and  the  individual 
commands  placed  in  procedures  or  functions  outside  the  main  program.  Unlike  the 
BASIC  version  of  DISKMON,  a  difference  exists  between  the  DISKMON 
commands  and  the  BIOS  function  call.  They  are  stored  in  separate  program 
sections.  This  has  the  advantage  that  the  BIOS  function  calls  can  be  easily 
transferred  as  stand  alone  modules  to  other  programs. 

Problems  with  addressing  the  data  buffer  don't  exist  in  C  or  in  Pascal  as  they  do  in 
BASIC.  The  buffer  is  a  local  variable. 
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There  are  two  small  differences  between  the  C  and  Pascal  versions.  They  are  in  the 
screen  display  and  the  administration  of  constants  for  unit  number,  disk  side,  etc. 
While  the  Pascal  version  defines  these  as  global  variables,  the  C  version  defines 
them  as  local  variables  within  the  mainQ  program  area. 

C  doesn't  allow  easy  window  definition  for  performing  tasks.  This  is  why  the  C 
version  of  DISKMON  doesn’t  use  the  first  screen  line  as  a  status  line  to  output  a 
copyright  notice  and  call  the  Help  command. 

C  listing:  DISKMONC.C 


/*************************■/!********************************************/ 
/*  DISKMONC  */ 

/* - */ 

/*  Task  :  DISKMCW  is  a  short  disk  monitor  program,  */ 

/*  using  BIOS  interrupt  13 (h)  functions  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  Developed  on  :  08/15/1987  */ 

/*  last  update  :  06/08/1989  */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  ;  CL  /AS  DISKMONC.C  */ 

/*  Call  :  DISKMONC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  Make  sure  Case-sensitive  link  is  OFF  before  */ 

/*  compiling  &  linking  */ 

/*  Select  Compile/Make  or  RUN  (no  project  file)  */ 

/*-k-k-k -kifkli-kitltlfkititifititlfkifk-klfk-k-k-kifklt  ***************  If-k-k-k-k-k-k-k-k  ************* -k*  / 


♦include  <dos.h> 

♦include  <stdlo.h> 

♦include  <ctype.h> 

typedef  unsigned  char  byte;  /*  Create  a  byte  */ 

/  * ==  Const  ants  ========*===============================*===========*  / 


♦define  FALSE  0  /*  Constants  to  make  reading  the  */ 

♦define  TRUE  1  /*  source  code  easier  */ 


♦define  NUL  0 

♦define  BEL  7 

♦define  BS  8 

♦define  TAB  9 

♦define  LF  10 

♦define  CR  13 

♦define  EF  26 

♦define  ESC  27 


/*  null  character  */ 
/*  bell  character  code  */ 

/*  backspace  character  code  */ 

/*  tab  character  code  */ 

/*  linefeed  character  code  */ 

/*  Return  key  code  */ 
/*  End  of  file  code  */ 
/*  Escape  code  */ 


Macros 


♦ifndef  MK_FP  /*  MK_FP  still  undefined?  */ 

♦define  MK_FP(s,o)  ((void  far  *)  (((unsigned  long) (s)  «  16)  |  (o) ) ) 
♦define  peekb  (a,  b)  (*  ( (byte  far  *)  MK_FP  ( (a) ,  (b) ) ) ) 

♦endif 


/* —  The  following  macros  state  the  offset  and  segment  addresses  of  — */ 
/* —  any  pointer - */ 
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♦define  GETSEG(p)  ( (unsigned) ({ (unsigned  long)  ((void  far  *)  p) )  »  16)) 
♦define  GETOFS(p)  ((unsigned)  ((void  far  *)  p) ) 

/★  —  Function  declarations - - - */ 


byte  DRead (  byte,  byte,  byte,  byte,  byte,  byte  far  *  ) ; 
byte  DWrite (  byte,  byte,  byte,  byte,  byte,  byte  far  *  ); 

/ *==  Struct ures  / 


struct  FormatDes  {  /*  Describes  format  of  a  sector  */ 

byte  Trac)c, 

Side, 

Sector,  /*  logical  sector  number  */ 

Length; 

}; 


/*  RESETDISK:  Reset  all  drives  connected  to  system  */ 
/*  Input  :  none  */ 
/*  Output  :  error  status  */ 


byte  ResetDiskO 


{ 

union  REGS  Register;  /*  Register  variable  for  interrupt  call  */ 

Register. h. ah  =0;  /*  Function  number  for  reset  =  0  */ 

Register. h.dl  =0;  /*  Reset  disk  drives  */ 

int86(0xl3,  ^Register,  ^Register) ;  /*  Call  BIOS  disk  interrupt  */ 

/*  print f ("Result :  %d\n".  Register. h. ah) ;  */ 
return (Register. h. ah) ;  /*  Return  error  status  */ 

} 


/*  WDS:  Display  status  of  the  last  disk  operation  */ 
/*  Input  :  see  below  */ 
/*  Output  :  TRUE  if  no  error,  otherwise  FALSE  */ 


byte  WDS (Status) 

l&te  Status;  /*  Disk  status  */ 


{ 

if  (Status) 

{ 

print f ("ERROR:  "); 
switch  (Status) 

{ 


/*  Error  occurred?  */ 
/*  YES  */ 

/*  Display  error  msg  */ 


case  0x01 
case  0x02 
case  0x03 
case  0x04 
case  0x06 
case  0x08 
case  0x09 
case  0x10 
case  0x20 
case  0x40 


printf ("Function  number  not  permittedNn") ; 
break; 

printf ("Address  marking  not  found\n"); 
break; 

printf ("Disk  is  wri t e-protect ed\n" ) ; 
break; 

printf ("Sector  not  found\n"); 
break; 

printf ("Disk  changedNn"); 
break; 

printf ("DMA  overflowNn") ; 
break; 

printf ("Data  transfer  past  segment  limlt\n") ; 
break; 

printf ("Read  errorXn"); 
break; 

printf ("Disk  controller  errorXn"); 
break; 

printf ("Track  not  found\n"); 
break; 


317 


7.  The  BIOS 


PC  System  Programming 


case  0x80  :  print f  (•’Time  Out  errorXn"); 
break; 

case  Oxff  :  print f (“Illegal  parameterXn" ) ; 
break; 

default  :  print f ("Error  %d  unknownXn",  Status); 

} 

ResetDiskO;  /*  Execute  reset  on  error  */ 

} 

return ( ! Status) ; 

} 

/ -k -k-k  ** -k -k*  * -k*  *-kit -k -k-k  * -k*  ************  1fk*1fk-k-k1fk-k***-k-k-k-k-k-kifk-kit  ********** -kit -k -k*  / 

/*  DREAD:  Read  specified  sector  from  disk  */ 

/*  Input  :  see  below  */ 

/*  Output  :  error  status  */ 

/**********************************************************************/ 


Sector,  Number,  Buffer) 

/*  Drive  number  */ 
/*  Disk  side  or  read-write  head  number  */ 
/*  Track  number  */ 
/*  First  sector  to  be  read  */ 
/*  Number  of  sectors  to  be  written  */ 
/*  FAR  pointer  to  a  byte  vector  */ 


/*  Register  variable  for  Interrupt  call  */ 
/*  Variables  for  segment  register  */ 


byte  DRead (Drive,  Side,  Track, 
byte  Drive, 

Side, 

Track, 

Sector, 

Number, 
far  *  Buffer; 

{ 

union  REGS  Register; 

struct  SREGS  SRegs; 

Register. h. ah  =  2; 

Register. h.al  Number; 

Register. h.dh  =  Side; 

Register. h.dl  =  Drive; 

Register. h.ch  =  Track; 

Register. h. cl  =  Sector; 

Register. x.bx  =  GETOFS  (  Buffer  ); 

SRegs.es  =  GETSEG(  Buffer  ); 

int86x(0xl3,  ^Register,  &Register, 

return (Register. h. ah) ; 

} 


/*  Function  no.  for  read  is  2  */ 
/*  Number  in  AL  register  */ 
/*  Side  in  DH  register  */ 
/*  Drive  number  in  DL  */ 
/*  Track  in  CH  register  */ 
/*  Sector  in  CL  register  */ 
/*  Offset  address  of  buffer  */ 
/*  Segment  address  of  buffer  */ 
&SRegs) ; 

/*  Return  error  status  */ 


/******************************★** *★**********★****★**★★**★*******★****/ 
/*  DWRITE:  Write  to  the  specified  nun±>er  of  sectors  */ 

/*  Input  :  see  below  */ 

/*  Output  :  error  status  */ 

/******************************************** *************k ************ / 


byte  DWrite (Drive,  Side, 
byte  Drive, 

Side, 

Track, 

Sector, 

Number, 
far  *  Buffer; 


Track,  Sector,  Number,  Buffer) 

/*  Number  of  drive  to  be  accessed  */ 
/*  Disk  side  or  number  of  read-write  head  */ 
/*  Track  number  */ 
/*  First  sector  to  be  written  */ 
/*  Number  of  sectors  */ 
/*  FAR  pointer  to  a  byte  vector  */ 


{ 

union  REGS  Register;  /*  Register  variable  for  interrupt  call  */ 


struct  SREGS  SRegs; 

Register. h. ah  =3; 

Register. h.al  =  Number; 

Register. h.dh  =  Side; 

Register. h.dl  =  Drive; 

Register. h.ch  =  Track; 

Register. h. cl  =  Sector; 

Register. x.bx  =  GETOFS(  Buffer  ); 
SRegs . es  =  GETSEG (  Buffer  ) ; 
int86x(0xl3,  &Register,  ^Register, 
return (Register. h. ah) ; 

} 


/*  Segment  register  variables  */ 

/*  Function  no.  for  write  is  3  */ 
/*  Number  in  AL  register  */ 
/*  Side  in  DH  register  */ 
/*  Drive  number  in  DL  */ 
/*  Track  in  CH  register  */ 
/*  Sector  in  CL  register  */ 
/*  Offset  address  of  buffer  */ 
/*  Segment  address  of  buffer  */ 
fiSRegs);  /*  BIOS  disk  int.  call  */ 
/*  Return  error  status  */ 
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/***** 


/ 

/ 

/ 

/ 

/* 

/* 

/* 

/** 


FORMAT:  format  a  track 


Input  :  see  below 

Output  :  error  status 

Info  :  BYTES  parameter  gives  the  number  of  bytes  in  the  for¬ 

matted  sector.  The  following  codes  are  allowed: 

0  *  128  bytes,  1  =  256  bytes 
2  =  512  bytes,  3  =  1024  bytes 


*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 


**********  *********** 


byte  Format (Drive,  Side,  Track,  Number,  Bytes) 
byte  Drive, 

Side, 

Track, 

Number, 

Bytes; 


/*  Side/ head  number  */ 
/*  Track  to  be  formatted  */ 
/*  Number  of  sectors  in  this  track  */ 
/*  Number  of  bytes  per  sector  */ 


{ 


union  REGS  Register; 
struct  SREGS  SRegs; 
struct  FormatDes  Formate [15]; 
byte  i; 


/*  Register  variable  for  interrupt  call  */ 
/*  Segment  register  variables  */ 
/*  Maximum  of  15  sectors  */ 
/*  Loop  counter  */ 


if  (Number  <= 

{ 

for  (i  =  0; 

{ 


15) 

i  <  Number;  i++) 


Formate [i] .Track  =  Track; 

Formate [i] .Side  =  Side; 

Formate [i] .Sector  =  i+1; 

Formate [i] .Length  =  Bytes; 

} 

Register .h. ah  =  5;  / 

Register .h.al  =  Number; 

Register .h.dh  =  Side; 

Register .h.dl  =  Drive; 

Register .h.ch  =  Track; 

Register .x.bx  =  GETOFS  (  Formate  ) 
SRegs. es=GETSEG (  Formate  ); 
int86x(0xl3,  ^Register,  &Register, 
return (Register .h. ah) ; 


} 

else  return (OxFF) ; 

) 


/*  Is  number  o.k.?  */ 

/*  Set  sector  descriptor  */ 

/*  Track  number  */ 
/*  Disk  side  */ 
/*  Sector  increments  by  1  */ 
/*  Number  of  bytes  in  sector  */ 

^  Function  number  for  formatting  */ 
/*  Number  in  AL  */ 

/*  Side  number  in  DH  */ 

/*  Drive  in  DL  */ 

/*  Track  number  in  CH  */ 

‘  /*  Offset  addr.  of  table  */ 

/*  Segment  address  of  buffer  */ 
&SRegs) ;  /*  Call  BIOS  disk  intr.*/ 
/*  Return  error  status  */ 

/*  Illegal  parameters  */ 


/*  CONSTANTS  :  Change  drive  number,  disk  side  and  disk  type  */ 
/*  (PC/XT  or  AT)  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 


void  Constants (Drive,  Side,  FTyp,  AT) 
byte  *Drive, 

♦Side, 

FTyp, 

AT; 


/*  Pointer  to  drive  variable  */ 
/*  Pointer  to  side  variable  */ 
/*  Disk  drive  type  */ 
/*  TRUE  if  ccatqputer  is  an  AT  */ 


{ 

printf ("Drive  number  (0-3):  "); 
scanf ("%d" ,  &Drive) ; 
printf ("Disk  side  (0  or  1):  "); 
scanf ("%d",  &Side); 
if  (AT) 

{ 

printf ("Format  parameter :\n") ; 
printf ("  1  =  320/360K  diskette 

printf  ("  2  =  320/360K  diskette 

printf ("  3  =  1.2MB  diskette  in 


/*  Read  drive  number  */ 

/*  Read  head  number  */ 
/♦  Used  only  by  ATs  ♦/ 


in  320/360K  driveXn"); 
in  1.2MB  driveXn"); 

1.2MB  drive  -  please  enter  choice:  "); 
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scanf(”%d",  &FTyp) ; 


} 


) 


/******* ************************** 
/*  HELP:  Display  help  screen 
/*  Input  :  none 

/*  Output  :  none 

/********************************* 


*/ 

*/ 

*/ 


void  HelpO 

{ 

printf ("\nDISKMON  (c)  1987  by  Michael  Tischer\n\n") ; 
printfC'C  OMMAND  OV  E-^R  VIE  W\n'*)  ; 

printf  (“ - \n'')  ; 

printf  ("  [E/e]  =  End\n*‘); 
printf (" [G/g]  =  Get  (read)\n"); 
printf  ('•  [S/s]  =  Fill  a  sector\n*'); 
printf (” [R/r]  =  Reset \n"); 
printf  ("  [F/f]  =  Format\n'') ; 
printf  ("  [C/c]  =  Constants\n'') ; 
printf  ("[?]  “  Help\n\n*')  ; 

} 


/*  GET  :  Read  a  disk  sector  and  display  it  on  the  screen  */ 
/*  Input  :  none  */ 
/*  Output  :  none  */ 


void  ReadSector (Drive,  Side) 

byte  Drive;  /*  Drive  number  */ 

byte  Side; 


/*  Disk  side  number  */ 


{ 

byte  Buffer [512]; 
int  i, 

Track, 

Sector; 


/*  Contents  of  filled  sector  */ 
/*  Loop  counter  */ 
/*  Track  in  which  filled  sector  lies  */ 
/*  Number  of  sector  to  be  filled  */ 


printf ("Track  :  "); 

scanf("%d",  &Track);  /*  Read  track  number  from  keyboard  */ 

printf ("Sector:  "); 

scanf("%d",  fiSector);  /*  Read  sector  number  */ 

if  (WDS (DRead (Drive,  Side,  Track,  Sector,  1,  Buffer))) 

{ 

printf  (" - ") ; 

printf  (" - ") ; 

for  (i  =0;  i  <  512;  i++)  /*  Display  characters  read  from  disk  */ 

/*  ASCII  code  conversion  */ 


switch 

1 

(Buffer [i ] ) 

i 

case 

NUL 

:  printf ("<NUL>")  ; 
break; 

case 

BEL 

:  printf ("<BEL>")  ; 
break; 

case 

BS 

:  printf ("<BS>")  ; 
break; 

case 

TAB 

:  printf ("<TAB>") ; 
break; 

case 

LF 

:  printf ("<LF>")  ; 
break; 

case 

CR 

:  printf ("<CR>") ; 
break; 

case 

ESC 

:  printf("<ESC>"); 
break; 

case 

EF  : 

printf ("<EOF>")  ; 
break; 

default 

:  print f("%c".  Buffer [i]! 
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printf  (“Xn - *') ; 

print f  - \n") ; 

} 


} 


/*  FORMAT:  Format  a  specified  number  of  sectors  in  a  track  with  */ 
/*  512  bytes  */ 
/*  Input  :  none  */ 
/*  Output  :  none  */ 


/★★*★*★★★★★★★★★*★★**★***★★***★★★****★**********★***★★★**★★*★*★★*★★★*★★*/ 


void  Formatit (Drive,  Side,  AT,  FTyp) 
byte  Drive,  /*  Drive  number  */ 

Side,  /*  Disk  side  number 
AT,  /*  TRUE  if  computer  is  an  AT 
FTyp;  /*  Disk  drive  type 


{ 

int  Track,  /*  Track  to  be  formatted 

Number;  /*  Number  of  sectors  to  be  formatted 


printf ("Track 
scanf(“%d",  STrack) ; 
printf ("No.  of  sectors 
scanf ( "%d" ,  SNumber) ; 
if  (AT) 

{ 

union  REGS  Register; 


/*  Read  track  number  from  keyboard 

*•); 

/*  Read  number  of  sectors 
/*  Is  computer  an  AT? 

/*  Register  variable  for  interrupt  call 


Register .h. ah  =  0x17;  /*  Function  no.  for  set  DASD-Type 

Register.h.al  =  FTyp; 

Register. h.dl  =  Drive; 

int86(0xl3,  SRegister,  ^Register) ;  /*  Call  BIOS  disk  interrupt 

} 

WDS (Format (Drive,  Side,  Track,  Number,  2,  AT,  FTyp) ) ; 

} 


/*  FILL  :  Fill  a  sector  with  a  character 
/*  Input  :  see  below 

/*  Output  :  none 


*/ 

*/ 

*/ 


*/ 

*/ 

*/ 

*/ 

*/ 

V 


*/ 

*/ 

*/ 

*/ 

*/ 


void  Filllt (Drive,  Side) 
byte  Drive; 
byte  Side; 


/*  Drive  number  */ 
/*  Disk  side  number  */ 


{ 

byte  Buffer [512]; 
int  i. 

Track, 

Sector; 

char  Character; 


/*  Contents  of  sector  to  be  filled  */ 
/*  Loop  counter  */ 
/*  Track  in  which  the  sector  lies  */ 
/*  Number  of  sector  to  be  filled  */ 
/*  Fill  character  */ 


printf ("Track  :  ") ; 

scanf  ("%d",  &Track) ; 
printf ("Sector  :  ") ; 

scanf ("%d",  SSector) ; 
printf ("Fill  char.  :  ") ; 
scanf ("\r%c",  ^Character) ; 
for  (i  =  0;  i  <  512;  Buffer [ 


/*  Read  track  number 

/*  Read  sector  number 

/*  Read  fill  character 
]  =  Character) 


from  keyboard  */ 
from  keyboard  */ 
from  keyboard  */ 


WDS (DWrite  (Drive,  Side,  Track,  Sector,  1,  (byte  far  *)  Buffer)); 

} 


/**  MAIN  PROGRAM  **/ 
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void  mainO 

{ 

int  Drive, 

Side, 

FTyp; 
byte  AT; 
char  Entry; 

Drive  »  Side  *  0; 

FTyp  *  3;  /*  1.2 

/* —  Read  PC  type  from  location  in 


/*  Drive  */ 
/*  Disk  side  */ 
/*  Disk  and  disk  drive  format  */ 
/*  Ccxnputer  type  (AT  or  PC/XT)  */ 
/*  Accept  user  input  */ 

/*  Default  of  drive  0,  side  0  */ 
-MB  diskette  in  1.2-MB  disk  drive  */ 

lOM-BIOS - */ 


AT  *  (((byte)  peekb(0xF000,  OxFFFE) )  ==  OxFC)  2  TRUE  :  FALSE; 
print f(-\n\nDISKMON  (c)  1987  By  Michael  Tischer\n\n"); 

WDS (ResetDisk 0 ) ;  /*  Execute  reset  first  */ 

do 


{ 


printfC?  =  Help>  •*); 
scanfC'Xr  %lc'*,  &Entry) ; 
switch (Entry  =  toupper (Entry) ) 
{ 


/*  Display  prompt  */ 
/*  Get  user  input  */ 
/*  Execute  command  */ 


case  '?' 
case  'R' 
case  'S' 
case  'F' 
case  'G' 
case  'C 
default 


:  HelpO;  /*  Display  help  screen  */ 

break; 

:  WDS (ResetDisk 0 ) ;  /*  Execute  reset  */ 

break; 

:  Filllt (Drive,  Side);  /*  Fill  a  sector  */ 

break; 

:  Formatit (Drive,  Side,  AT,  FTyp) ; 
break; 

:  ReadSector (Drive,  Side);  /*  Read  sectors  */ 

break; 

:  Constants (fcDrive,  &Side,  &FTyp,  AT); 
break; 

:  if  (Entry  !=  'E')  print f  ("Unknown  ccMtimand\n") ; 


I 


} 

while  (Entry  !=  'E');  /*  "E"  or  "e"  ends  program  */ 

} 
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7.8  Accessing  the  Hard  Disk  from  the  BIOS 

The  original  XT  models  included  10  megabyte  hard  disks.  Hard  disk  drives  are  now 
the  mass  storage  device  of  choice  on  PCs,  with  the  floppy  disk  running  a  close 
second.  However,  the  two  devices  have  many  features  in  ccnnmon. 

Like  the  floppy  disk,  a  hard  disk  consists  of  magnetized  plates,  also  called  disks, 
which  can  store  data  as  magnetic  impulses.  Unlike  the  floppy  disk,  a  hard  disk 
contains  several  of  these  disks.  The  plates  in  a  hard  disk  can  store  data  on  both 
sides,  and  therefore  must  have  a  read/write  head  above  and  below  each  disk  for 
reading  and  writing  data. 

Hard  disk  format 

Hard  disk  formatting  is  similar  to  that  of  a  floppy  disk:  Each  disk  is  divided  into 
tracks  which  have  sectors  within  them.  A  cylinder  consists  of  all  sectors  which  can 
be  accessed  without  moving  the  read/write  heads.  In  other  words,  the  heads  remain 
stationary  within  one  cylinder  while  the  disk  moves  beneath  them.  Moving  the 
heads  to  another  set  of  tracks  accesses  another  cylinder.  Every  cylinder  contains  the 
same  number  of  sectors,  which  in  turn  contain  a  constant  number  of  bytes. 

Partitions 

The  hard  disk  has  another  division  beyond  track,  sector  and  cylinder  levels: 
Partitions  allow  you  to  configure  parts  of  a  hard  disk  for  different  operating 
systems.  Although  you  can  format  a  disk  according  to  one  operating  system  and 
use  that  operating  system  exclusively,  hard  disks  allow  you  to  store  several 
operating  systems  at  once.  You  can  allocate  the  number  of  cylinders  needed  for 
each  operating  system  when  formatting  a  hard  disk.  The  first  sector  of  the  hard  disk 
contains  the  information  about  this  memory  allocation.  This  information  includes 
data  about  the  beginning  of  each  partition  and  its  size,  as  well  as  which  operating 
system  lies  in  this  partition  (e.g.,  DOS  has  code  1).  It  also  records  which 
operating  system  is  active  and  which  operating  system  should  be  started  during  the 
system  boot 

XT  and  AT  models  can  control  hard  disks  capable  of  storing  10  megabytes,  20 
megabytes,  40  megabytes  and  more.  Both  hard  disks  have  2  disks  (4  sides) 
(numbered  0  through  3)  and  accept  17  sectors  per  cylinder  of  512  bytes  each.  The 
difference  in  capacity  lies  only  in  the  number  of  cylinders.  The  XT  hard  disk  has 
306  cylinders  numbered  from  0  to  305  on  each  side  of  its  disk  medium;  the  AT  has 
615  cylinders  numbered  from  0  to  614  on  each  side  of  its  disk  medium.  The  XT 
hard  disk  has  a  minimum  capacity  of  10.16  megabytes  and  the  AT  hard  disk  a 
minimum  capacity  of  20.41  megabyte. 

Note:  Exercise  extreme  caution  when  using  the  BIOS  hard  disk  access 

functions.  Unlike  a  disk  drive  which  you  can  test  out  with  an  unused 
disk,  you  can't  do  the  same  with  a  hard  disk.  Careless  use  of  the 
Write  or  Formatting  function  could  lead  to  irretrievable  data  loss.  If 
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you  plan  to  try  these  functions,  back  up  the  entire  hard  disk  before 
you  try  these  functions. 

BIOS  accesses  the  hard  disk  through  interrupt  13H — the  same  interrupt  used  for 
floppy  disk  access.  The  individual  functions  are  identical  for  hard  disk  and  floppy 
disk  drives,  but  hard  disk  control  is  very  different  from  floppy  disk  drive  control. 
BIOS  uses  different  modules  for  controlling  the  hard  disk  and  disk  drives.  When 
you  call  interrupt  13H,  it  accesses  the  hard  disk  routine  first.  This  routine  tests 
whether  the  hard  disk  or  floppy  disk  drive  should  be  addressed,  based  on  the  device 
number  in  the  DL  register.  If  the  hard  disk  is  involved,  it  calls  the  proper  routine 
in  the  hard  disk  module.  On  the  other  hand,  if  the  floppy  disk  drive  should  be 
addressed,  another  module  must  be  called  by  calling  interrupt  40H,  which  points  to 
the  old  disk  interrupt  13H. 

All  hard  disk  functions  share  the  condition  that  after  the  function  call  they  use  the 
carry  flag  to  signify  whether  they  could  perform  their  task  or  if  an  error  occurred.  If 
this  is  the  case,  the  carry  flag  sets  and  an  error  code  passes  to  the  AH  register.  The 
individual  codes  have  the  following  meanings: 


OlH 

Addressed  unavailable  function  or  drive  I 

02H 

04H 

Sector  not  found 

OSH 

Error  durinq  controller  reset 

07H 

Error  durinq  controller  initialization 

09H 

DMA  transmission  error:  Seqment  border  crossed 

OAH 

Sector  defective 

lOH 

Read  error 

IIH 

Read  error  corrected  with  ECC 

20H 

Controller  defect 

40H 

Search  operation  failed 

80H 

Drive  does  not  respond  (Time  out) 

AAH 

Drive  not  ready 

CCH 

Write  error 

When  any  one  of  these  errors  occur  except  error  01,  execute  a  reset  and  try  calling 
the  function  again.  Most  of  the  time  the  error  won’t  recur. 

More  about  errors 

If  error  1 IH  occurs  during  the  read  function,  the  data  read  in  may  not  actually  be 
defective.  This  error  indicates  that  a  read  error  occurred,  but  that  it  could  be 
corrected  with  the  help  of  the  ECC  (Error  Correction  Code)  algorithm.  This 
procedure  is  similar  to  the  CRC  (Cyclic  Redundancy  Check)  process  used  in  the 
disk  drives.  A  complicated  mathematical  formula  adds  the  individual  bytes  of  a 
sector.  The  result  of  the  process  goes  to  the  disk  in  the  form  of  a  sector  plus  four 
bytes.  If  a  read  error  occurs,  it  can  be  corrected  within  certain  limits  with  the  help 
of  the  stored  ECC  results. 
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The  use  of  processor  registers  for  data  transmission  becomes  another  parallel 
between  the  hard  disk  and  floppy  disk  functions.  The  function  number  passes  to 
the  AH  register.  If  the  program  requires  the  number  of  the  hard  disk  to  be 
addressed,  it  always  passes  to  the  DL  register.  The  value  80H  always  stands  for  the 
first  hard  disk,  and  81H  for  the  second  hard  disk.  The  number  of  the  read/write  head 
(and  indirectly  of  the  disk  addressed)  passes  to  the  DH  register.  The  CH  register 
accepts  the  cylinder  number.  Remember  that  a  10  megabyte  hard  disk  has  more 
than  306  cylinders.  Since  this  8-bit  register  can  only  address  256  cylinders  at  a 
time,  this  register  alone  isn't  enough  to  indicate  the  cylinder  number. 

For  this  reason  bits  6  and  7  of  the  CL  register  help  indicate  the  cylinder  number. 
They  form  bits  8  and  9  of  the  cylinder  number,  p^mitting  an  addressable  range  of 
1,024  cylinders  (0-1,023).  Bits  0  to  5  of  the  CL  register  provide  the  number  of  the 
sector  to  address  (they  are  numbered  from  1  to  17  in  each  cylinder).  If  you  attempt 
to  access  several  sectors  at  a  time,  the  numbers  of  these  sections  pass  to  the  AL 
register.  During  read/write  operations  a  buffa*  address  must  be  indicated  from  which 
data  can  be  read  or  to  which  data  can  be  transferred.  In  such  a  case,  the  £S  register 
passes  the  segment  address  and  the  BX  regist^  the  offset  address  of  this  buffer. 

Function  OOH:  Reset 

Function  OH  resets  the  controller  without  the  need  of  any  other  parameters.  After 
an  error  occurs,  this  function  should  always  be  called  before  the  next  data  access. 
The  information  from  the  hard  disk  on  which  the  execution  of  the  reset  is  based 
passes  to  the  DL  register. 

Function  01 H:  Status 

Function  OlH  reads  the  hard  disk  drive  status  (this  status  is  indicated  after  every 
hard  disk  operation).  The  number  of  the  drive  whose  status  should  be  read  must  be 
stored  in  the  DL  register. 

Function  02H:  Read  sector 

Function  02H  reads  one  or  more  sectors.  A  single  call  of  this  function  can  read  up 
to  128  sectors.  This  limitation  occurs  because  the  hard  disk  controller  transfers  data 
directly  into  RAM  through  the  DMA.  The  DMA  chip  can  only  transfer  a 
maximum  of  64K  at  a  time,  in  one  memory  segment  at  a  time.  For  this  reason,  it 
is  important  that  the  complete  buffer  whose  address  passes  to  ES:BX  fits  into  the 
64K  starting  with  the  segment  address  in  ES.  Otherwise  the  DMA  chip  may  report 
an  error. 

This  function  initially  reads  all  sectors  in  numerical  order  within  the  cylinder 
indicated,  using  the  read/write  head  indicated.  Once  the  function  reads  the  last  sector 
of  a  cylinder,  and  additional  sectors  should  be  read,  reading  continues  with  the  frrst 
sector  of  the  same  cylinder,  but  using  a  diff^nt  read/write  head.  After  the  function 
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accesses  the  last  read/write  head  and  additional  sectors  still  remain,  the  read  process 
continues  in  the  first  sector  of  the  following  cylinder  on  the  first  lead/write  head. 

Function  03:  Write  sector 

Function  OSH  writes  one  or  more  sectors.  A  single  call  of  this  function  can  write 
data  in  up  to  128  sectors.  This  limitation  is  also  caused  by  the  DMA  (see  function 
02H  above). 

This  function  initially  writes  all  sectors  in  numerical  order  within  the  cylinder 
indicated,  using  the  read/write  head  indicated.  Once  the  function  writes  to  the  last 
sector  of  a  cylinder,  and  additional  sectors  should  be  written,  writing  continues 
with  the  first  sector  of  the  same  cylinder,  but  using  a  different  read/write  head. 
After  the  function  reaches  the  last  read/write  head  and  additional  sectors  still 
remain,  the  write  process  continues  in  the  first  sector  of  the  following  cylinder  on 
the  first  read/write  head. 

Function  04H:  Verify 

Function  04H  verifies  the  different  sectors  of  a  cylinder.  No  comparison  occurs 
between  the  data  on  the  disk  and  the  data  in  memory  (no  buffer  address  needed  in 
ES:BX).  ECC  numbers  verify  whether  the  bytes  stored  return  the  same  results  after 
processing  through  the  ECC  algorithm.  The  AL  register  indicates  the  number  of 
sectors  to  be  verified. 

Function  OSH:  Format 

Function  OSH  formats  the  hard  disk.  Before  a  hard  disk  can  be  accessed  it  must  be 
formatted.  Similar  to  the  function  used  for  formatting  a  disk,  this  function  must 
know  the  read/write  head  and  cylinder  number.  In  addition,  it  must  pass  the  address 
of  the  buffer  to  the  register  pair  ES:BX.  This  buffer  must  be  512  bytes  long,  even 
if  the  function  only  accesses  the  first  34  bytes.  It  contains  two  bytes  for  each  of 
the  17  sectors  to  be  formatted.  The  first  byte  indicates  whether  the  sector  is  in 
good  condition.  Assuming  that  every  sector  is  in  good  condition,  the  value  0  is 
entered  into  this  byte.  The  second  byte  accepts  the  logical  number  which  should  be 
assigned  to  the  current  sector.  BIOS  takes  information  from  the  first  two  bytes  in 
the  table  about  the  first  physical  sector  of  the  cylinder.  Bytes  3  and  4  supply 
information  about  the  second  physical  cylinder.  Once  the  physical  series  has 
already  been  determined,  the  logical  sequence  of  the  sectors  can  be  set  through  2 
bytes  of  a  sector  indication  in  this  table. 

The  numbers  differ  between  a  logical  sector  and  its  respective  physical  sector.  This 
shift  in  logical  sectors,  called  sector  interleavings  help  optimize  access  time  on  a 
hard  disk. 
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The  average  hard  disk  rotates  at  60  revolutions  per  second.  This  means  that  the 
next  physical  sector  appears  under  the  read/write  head  every  thousandth  of  a  second. 
The  hard  disk  controller  is  incapable  of  transferring  the  512  bytes  of  the  sector 
previously  read  into  the  PC's  memory.  For  this  reason,  the  logical  sectors  shift  in 
relation  to  the  physical  sectors,  so  that  the  next  logical  sector  only  appears  under 
the  read/write  head  after  the  hard  disk  controller  completes  the  transmission  of  the 
last  sector. 

The  interleave  factor,  i.e.,  the  number  of  sectors  by  which  the  logical  sectors  shift 
in  relation  to  the  physical  sectors,  depends  on  the  relationship  between  the  speed  at 
which  the  hard  disk  revolves,  and  the  processing  speed  of  the  hard  disk  controller. 
For  example,  if  the  interleave  factor  is  6,  this  means  that  for  every  sector  read,  a 
"jump"  of  5  sectors  takes  place  before  the  next  logical  sector  follows.  The  closer 
this  factor  comes  to  1  (in  which  case  the  physical  and  logical  sectors  are  identical), 
the  faster  the  hard  disk  and  the  closer  the  transmission  speed  comes  to  the  physical 
limit. 

While  XT  hard  disks  operate  with  an  interleave  factor  of  1:6,  AT  hard  disks  are 
twice  as  fast,  with  an  interleave  factor  of  1:3.  The  effects  of  the  interleave  factor 
and  the  relationship  between  logical  and  physical  sectors  can  be  seen  in  the 
following  table: 


AT:  physical  logical 

sector 

XT:  physical 

sector 

logical 

sector 

sector 

1 

1 

1 

1 

2 

7 

2 

4 

3 

B 

3 

7 

4 

2 

4 

10 

5 
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5 

13 

6 

14 

6 

16 

7 

3 

7 

2 

8 

9 

8 

5 

9 

15 

9 

8 

10 

4 

10 

11 

U 

10 

11 

14 

12 

16 

12 

17 

13 

5 

13 

3 

14 

11 

14 

6 

15 

17 

15 

9 

16 

6 

16 

12 

17 

12 

17 

15 

During  a  function  call,  BIOS  enters  a  value  into  the  first  byte  of  a  sector  marker 
which  tells  the  calling  program  whether  or  not  the  sector  is  OK.  The  value  0 
means  OK,  and  the  value  128  means  a  magnetization  error  occurred.  Besides  the 
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registers  mentioned  above,  the  AL  regist^  accepts  the  number  of  sectors  to  be 
processed.  Since  the  cylinders  of  the  AT  and  XT  hard  disks  have  IT-sector  formats, 
the  AL  register  should  contain  the  value  17  during  the  call  of  this  function. 

Function  OSH:  Check  disk  specs 

Function  OSH,  passing  the  number  of  the  hard  disk  in  the  DL  register,  checks  hard 
disk  specifications.  This  is  important  for  examining  hard  disks  with  unusual 
formats. 

After  the  function  call  the  DL  regist^  contains  the  numb^  of  attached  hard  disks. 
This  number  can  be  0, 1  or  2.  In  addition,  the  DH  regist^  contains  the  number  of 
read/write  heads.  Since  the  read/write  head  count  always  starts  at  0,  a  value  of  7 
means  that  8  heads  are  available.  The  CL  regist^  (bits  0-7  of  the  cylinder  number) 
and  the  upper  two  bits  of  the  CH  register  (bits  8  and  9  of  the  cylinder  number) 
indicate  the  number  of  cylinders.  The  counting  here  also  starts  at  0.  The  last 
information  is  found  in  the  lower  6  bits  of  the  CH  register.  It  shows  the  number 
of  sectors  per  cylinder,  where  the  counting  begins  at  1  (an  exception  to  the  rule, 
since  the  other  counts  in  this  function  begin  with  0). 

When  a  user  interfaces  a  foreign  hard  disk  to  a  PC,  the  BIOS  must  know  the 
characteristics  of  this  hard  disk  to  perform  correct  access.  For  this  reason  it  uses 
interrupt  41H  for  hard  disk  0  and  the  interrupt  46H  for  hard  disk  1  as  pointers  to  a 
table.  This  table  has  a  format  prescribed  by  BIOS  and  describes  the  attached  hard 
disk  drive.  BIOS  stores  a  whole  series  of  tables  so  that  BIOS  can  adjust  itself 
properly  during  the  system  boot  from  the  booting  hard  disk  drive. 

Note:  If  the  hard  disk  is  already  in  the  ^  and  functions  properly,  do  not 

attempt  to  access  the  hard  disk  description  table,  since  the  hard  disk 
could  be  damaged. 

A  table  must  be  constructed  in  RAM  for  foreign  hard  disk  interfacing,  and  intemipt 
vectors  41H  or  46H  must  point  to  this  table.  In  addition,  function  9  must 
configure  BIOS  to  use  this  table.  The  number  9  declares  the  function.  The  number 
of  the  drive  (80H  or  81H)  is  loaded  into  the  DL  register.  You  may  ncw&c  have  to 
use  this  complicated  function;  Most  hard  disk  manufacturers  include  a 
configuration  program  which  performs  the  same  task.  Check  the  documentation 
which  came  with  the  hard  disk  for  the  parameters  needed  for  the  hard  disk 
description  table. 

Function  OAH:  read  ECC 
Function  OBH;  Write  ECC 

Functions  OAH  and  OBH  are  additional  read/write  functions.  They  differ  from 
functions  2  and  3  in  that  they  read  and  write  the  four  ECC  bytes  at  the  end  of  each 
sector  in  addition  to  the  512  bytes  of  data.  Because  of  this,  every  sector  has  516 
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bytes  instead  of  512  bytes,  and  only  127  sectors  can  be  read  or  written  at  one  time, 
instead  of  128  as  in  functions  2  and  3. 

Function  OBH:  Recalibrate 

Function  OBH  recalibrates  one  of  two  hard  disks.  It  also  returns  the  error  status, 
passing  the  error  number  to  the  DL  regist^. 

Function  10H:  Check  ready  status 

Function  lOH  tests  whether  or  not  the  hard  disk  whose  number  is  in  the  DL 
register  is  currently  prepared  to  execute  commands.  If  the  carry  flag  is  set  on  the 
return  of  this  function,  the  hard  disk  isn’t  ready.  An  error  code  passes  to  the  AH 
register. 

Function  14H:  Self  test 

Function  14H  forces  the  controller  to  perform  an  internal  self  test.  If  the  controller 
is  OK,  it  returns  with  a  reset  carry  flag. 

Function  15H:  Check  drive  type 

Function  15H  determines  the  type  of  drive.  The  number  of  the  drive  (80H  or  81H) 
passes  to  the  DL  register.  If  the  drive  is  unavailable,  it  returns  the  value  0  in  the 
AH  register  after  the  function  call.  If  the  AH  register  contains  a  value  of  1  or  2, 
the  device  indicated  is  a  floppy  disk  drive.  The  value  3  indicates  a  hard  disk.  If  this 
is  the  case,  the  CX  and  DX  registers  contain  the  number  of  sectors  on  this  hard 
disk.  The  two  registers  form  a  32-bit  number  (the  CX  register  contains  the  upper 
16  bits,  and  the  DX  register  the  lower  16  bits). 

Note:  We  chose  not  to  include  demonstration  programs  in  this  section, 

because  accessing  a  hard  disk  without  proper  knowledge  can  have 
serious  consequences.  While  floppy  disk  drive  access  can  be  practiced 
with  an  unused  or  empty  disk  without  worrying  about  damage,  you 
only  get  one  hard  disk  with  a  PC.  One  small  mistake  during  access 
could  destroy  all  data  on  a  hard  disk. 

Avoid  hard  disk  access  using  BIOS  functions  unless  absolutely  necessary.  Leave 
these  tasks  to  DOS  functions  as  much  as  possible. 
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7.9  Accessing  the  Serial  Port  from  the  BIOS 

Computers  in  every  part  of  the  world  communicate  with  each  other  and  exchange 
data.  Most  of  the  time  these  computers  use  normal  telephone  lines  for  this 
communication.  I^one  lines  only  permit  slow  data  transfer,  but  allow  users  to 
communicate  from  almost  anywhere  on  the  planet.  Data  transfers  serially  (i.e.,  one 
bit  at  a  time),  while  the  send^  and  receiver  maintain  similar  tranter  protocols 
(parameters  for  data  transf^). 

Serial  card 

Since  basic  PC  configurations  aren't  equipped  for  this  type  of  data  transmission, 
data  transfo-  is  only  possible  when  the  user  adds  an  asynchronous  communication 
port  (IBM's  catch  phmse  for  an  RS-232  card,  or  serial  interface  card). 

This  type  of  card  enables  data  transfer  between  two  computers  direct  through  a 
cable  or  through  phone  lines.  Both  the  sender  and  receiver  require  a  modem  to 
communicate  using  the  latter  method.  Modems  convert  computer  signals  into 
acoustical  signals  which  can  then  be  transmitted  ov^  telephone  lines. 

In  addition  to  hardware,  data  communication  requires  software  which  controls  the 
RS-232  card.  BIOS  offers  this  software  in  four  functions  called  by  interrupt  14H. 
Before  discussing  these  functions  in  detail,  let's  examine  data  transfer  protocol. 


logical 

logical 


Direction  of  data  flow^ 

LSB  MSB 


Asynchronous  transmission  protocol 
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Word  length 

As  the  figure  above  shows,  only  the  two  line  states,  0  and  1  (also  called  high  and 
low)  are  important.  The  line  remains  high  if  no  data  transmission  takes  place.  If 
the  line’s  state  changes  to  low,  the  receiver  knows  that  data  is  being  transmitted. 
Between  5  and  8  bits  transfer  over  the  line,  depending  on  the  word  length. 
Unfortunately  the  BIOS  functions  only  support  a  word  length  of  7  or  8  bits.  If  the 
line  is  low  during  data  transmission,  this  means  that  the  bit  to  be  sent  is  0.  High 
signals  a  set  bit.  The  least  significant  bit  is  transferred  first,  and  the  most 
significant  bit  of  the  character  to  be  transmitted  is  transfOTed  last. 


Parity 


The  character  can  be  followed  by  a  parity  bit  which  permits  OTor  detection  during 
data  transmission.  Parity  can  be  even  or  odd.  For  even  parity,  the  parity  bit 
augments  the  data  word  to  be  transmitted,  so  that  an  even  number  of  bits  results. 
For  example,  if  the  data  word  to  be  transmitted  contains  three  bits  set  to  1,  the 
parity  bit  becomes  1  so  that  the  number  of  1  bits  increments  to  four,  making  an 
even  number.  If  the  data  word  contained  an  even  number  of  1  bits,  the  parity  bit 
would  be  zero.  For  odd  parity  the  parity  bit  is  set  in  such  a  manner  that  the  total 
number  of  1  bits  is  odd. 

Stop  bits 

The  stop  bits  signal  the  end  of  the  transmission  of  data.  Data  transmission 
protocol  permits  1,  1.5  and  2  stop  bits.  Some  users  are  confused  about  the  option 
of  working  with  1.5  stop  bits,  since  some  believe  that  you  can’t  divide  a  bit.  The 
explanation  for  this  paradox  comes  from  the  data  transmission  protocol. 

Baud  rate 

Old  standards  dictate  that  data  transfers  at  a  rate  of  300  baud  (about  300  bits  per 
second),  and  one  stop  bit.  The  signal  for  a  1  bit  and  the  signal  for  a  0  bit  are  both 
events.  Binary  bits  when  transmitted  in  an  analog  environment  such  as  phone  lines 
may  not  be  identical  with  baud  rates.  Since  stop  bits  always  have  the  value  1,  the 
line  would  be  high  for  1/300  second.  If  instead  you  keep  the  line  high  for  1/200 
second,  1.5  bits  are  transmitted.  The  line  remains  high  until  a  new  character 
transfers  and  sets  the  line  transmitting  the  start  bit  to  low. 

Some  interfaces  work  with  negative  logic.  In  such  a  case  the  conditions  for  0  and  1 
in  the  illustration  above  must  be  reversed.  This  doesn’t  change  the  basic  principle 
of  serial  transmission. 

Protocol  settings 

Data  transmission  only  works  if  the  sender  and  receiver  both  match  various 
protocol  parameters.  First  the  baud  rate  (the  number  of  bits  transmitted  per  second) 
must  be  set  The  standard  baud  rates  for  data  exchange  over  voice  telephone  lines 
are  300, 1200  and  2400  baud.  These  baud  rates  depend  on  the  capabilities  of  the 
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modem  in  use.  For  a  dedicated  (data  only)  telephone  line  or  for  direct  data 
transmission  through  a  cable,  speeds  up  to  9600  baud  are  possible.  Up  to  80  bytes 
per  second  or  4800  bytes  per  minute  can  be  transmitted  at  9600  baud. 

The  word  length  depends  on  the  data  being  transmitted.  If  the  data  consists  of 
normal  ASCII  characters,  a  7-bit  word  is  enough,  since  the  ASCII  character  set  has 
only  128  characters.  If  the  data  encompasses  the  complete  PC  set  of  256 
characters,  8-bit  words  are  more  practical. 

Next  the  necessity  of  a  parity  check  should  be  determined,  and  whether  even  or  odd 
parity  should  be  used.  In  most  cases  parity  checking  is  recommended,  since  phone 
lines  do  not  always  transmit  all  data  correctly.  The  parity  selected  is  unimportant, 
as  long  as  both  sender  and  receiver  select  the  same  parity. 

The  number  of  stop  bits  must  be  defined.  One  stop  bit  transmits  successive 
characters  faster  than  a  setting  of  two  stop  bits.  On  the  other  hand,  two  stop  bits 
increase  the  reliability  of  transmission. 

Sample  protocol 

The  following  illustration  shows  a  sample  transmission  of  an  *’ A”  character  with  a 
protocol  of  8  data  bits,  odd  parity  and  one  stop  bit.  Positive  logic  and  a  300  baud 
transmission  rate  are  assumed.  Since  the  ASCII  code  of  the  "A"  character  is  65 
(01000001(b))  and  therefore  contains  only  two  1  bits,  the  parity  bit  changes  to  1 
to  set  the  number  of  1  bits  to  an  odd  numl^r. 


logical  1 


logical  0. 


I .  r  I  I  I  I  I 
I _ 


start  bit 


8  data  bits 
(01000001  (b)  for  "A") 


T“i — I — r 


stop  bit 


|Tlme| 


|l/300  second  I 


[Parity  bit] 


Transmitting  A  character:  8-bit  word  length,  1  stop  bit,  odd  parity  and  300  baud 


UART 


The  brain  of  an  RS-232  card  is  the  UART  (Universal  Asynchronous  Receiver 
Transmitter).  You  should  be  familiar  with  the  design  and  capabilities  of  this 
processor,  so  that  you  can  properly  adapt  programs  to  the  error  messages  returned 
by  the  different  BIOS  functions. 


332 


Abacus 


79  Accessing  the  Serial  Port  from  the  BIOS 


Transfer  registers 

A  char^ter  transmitted  on  a  data  line  passes  first  to  a  register  designated  as  a 
transfer  holding  register.  It  remains  there  until  processing  ends  on  the  character 
piecing  it  Then  the  character  moves  to  the  tranter  sfdft  register  from  where  the 
UART  transmits  the  character  bit  by  bit  over  the  data  line.  Depending  on  the 
configuration,  parity  and  st(^  bits  implement  the  stream  of  data.  When  the  BIOS 
function  passes  the  status  of  the  data  lines  to  the  AH  register,  bits  5  and  6  indicate 
whetha*  these  two  registers  are  empty. 

Receiver  registers 

The  receiver  shift  register  accepts  received  data,  then  transmits  the  data  to  the 
receiver  data  register  where  the  UART  removes  the  parity  and  stop  bits.  If  a 
ineviously  received  character  is  still  in  the  data  register,  bit  1  of  the  line  status  sets 
to  1  to  avoid  overwriting.  Bit  0  indicates  that  a  character  was  received.  If  while 
processing  the  character,  the  UART  discov^  that  a  parity  error  occurred  during  the 
transmission,  it  sets  bit  2  of  the  line  status.  If  a  br^down  occurs  in  the  agreed- 
upon  protocol  (number  of  parity  and  stop  bits),  the  action  sets  bit  3.  The  UART 
always  sets  bit  4  if  the  data  line  remains  longer  in  low  (0)  status  than  required  for 
the  transmission  of  a  character.  Bit  7  signals  a  time  out  error.  This  occurs 
occasionally  when  the  communication  between  the  RS-232  card  and  the  modem 
isn't  working  properly. 


7  654  321  Obit 


Line  status 


Function  0:  Passing  protocoi 

Before  data  can  be  transmitted  or  received,  the  UART  must  be  informed  of  the 
number  of  stop  bits,  etc.  Function  0  of  interrupt  14H  serves  this  purpose.  The 
function  number  (0)  enters  the  AH  register,  and  the  protocol  passes  to  the  AL 
register.  The  bits  of  the  AL  register  indicate  the  various  parameters: 
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Bits 

Protocol  1 

bit  0,1 

Word  length 

10(b) 

-  7  bits 

11(b) 

-  8  bits 

bit  2 

Number  of  Stop  bits  I 

0-1 

Stop  bit  1 

CM 

1 

f — 1 

Stop 

bits 

bit  3,4 

Parity  check 

00(b) 

-  none 

01(b) 

-  odd 

10(b) 

-  even 

bit  5  -7 

Baud  rate 

000  - 

110 

Baud 

001  - 

150 

Baud 

010  - 

300 

Baud 

Oil  - 

600 

Baud 

100  - 

1200 

Baud 

101  - 

2400 

Baud 

110  - 

4800 

Baud 

111  - 

9600 

Baud 

After  initialization  the  function  loads  the  line  status  into  the  AH  register. 

Function  1:  Transmit  character 

Function  1  transmits  characters.  During  its  call,  the  AH  re;gister  must  contain  1 
and  the  AL  register  must  contain  the  character  to  be  transmitted.  If  the  character 
was  transmitted,  bit  7  of  the  AH  register  changes  to  0  after  the  function  call.  A  1 
signals  that  the  character  could  not  be  transmitted.  The  remaining  bits  correspond 
to  the  line  status. 

Function  2:  Receive  character 

Function  2  receives  characters.  After  calling  this  function  the  AL  register  contains 
the  character  received.  AH  contains  the  value  0  if  no  error  occurred,  otherwise  the 
value  corresponds  to  the  line  status. 

Function  3:  Line/modem  status 

Function  3  senses  and  returns  the  modem  status  and  line  status.  It  returns  the  line 
status  in  the  AH  register  and  the  modem  status  in  the  AL  register: 
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Bit  0 

Modem  ready  to  send  status  change 

Bit  1 

Modem  on  status  change 

Bit  2 

Bit  3 

Connection  to  receiver  status  change 

Bit  4 

Modem  ready  to  send 

Bit  5 

Modem  on 

Bit  6 

Bit  7 

Connection  to  receiver  modem  | 

Bits  4  to  7  represent  a  duplication  of  bits  0  to  3.  Bits  0  to  3  indicate  whether  the 
contents  of  bits  4  to  7  have  changed  since  the  last  reading  of  the  modem  status.  If 
this  is  the  case,  the  corresponding  bit  contains  the  value  1.  For  example,  if  bit  2 
contains  the  value  1,  this  means  that  the  content  of  bit  6  has  changed  since  the  last 
reading.  In  reality  it  means  that  the  phone  just  started  to  ring  or  has  stopped 
ringing,  depending  on  the  previous  value  of  bit  6. 
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7.10  The  Cassette  Interrupt 

The  cassette  interrupt  (intorupt  15H)  is  a  leftover  fipom  the  days  when  PCs  used 
cassette  recorders  exclusively  as  data  storage  devices.  This  intmupt  provided  four 
functions  (numbered  0  through  3)  for  enabling  and  disaUing  the  cassette  recorder 
motor,  reading  from  and  writing  to  magnetic  tape.  As  the  PC  gained  ground  in  the 
business  world,  the  disk  drive  became  popular.  Consequently,  the  cassette  drive’s 
popularity  faded. 

The  four  cassette  intmupt  functions  remain  part  of  the  PC's  ROM-BIOS.  The  XT 
has  no  cassette  recorder  int^ace.  In  addition,  the  XTs  cassette  intorupt  coisists  of 
a  short  routine  which  sets  the  carry  flag  and  stores  an  mor  code  in  the  AH  register 
to  tell  the  program  that  the  function  called  is  unavailable. 

The  AT  and  the  cassette  interrupt 

The  cassette  interrupt  returned  with  the  introduction  of  the  AT.  New  functions  can 
be  called  which  have  nothing  to  do  with  cassette  recorder  control.  The  following 
describes  these  functions,  available  only  on  AT  models. 

Among  other  things,  the  interrupt  makes  two  functions  available  based  on  the 
time  measurement  of  the  onboard  AT  realtime  clock.  The  first  of  these  is  function 
83H.  It  is  useful  in  situations  where  the  CPU  is  engaged  in  a  time  consuming  task 
(e.g.,  computing  a  complicated  formula),  but  other  duties  must  be  performed  at  the 
same  time  (e.g.,  checking  the  keyboard  to  determine  if  the  user  wants  to  terminate 
the  operation). 

Function  83H:  Time  fiag 

Fuiiction  83H  calls  the  address  of  a  flag  (a  byte  in  the  us»  program)  in  which  the 
highest  level  bit  is  set  after  a  certain  time  period  has  eky)sed.  Within  an  executing 
program  this  flag  can  be  tested  after  certain  amounts  of  time.  Only  two  assembly 
language  instructions  are  necessary  for  this,  so  the  testing  requires  little  time. 
Function  number  83H  passes  information  to  the  AH  register.  The  segment  address 
of  the  flag  is  loaded  into  the  ES  register  and  the  offset  address  into  the  BX  register. 
The  time  that  should  elapse  until  the  flag  is  set  is  passed  to  the  CX  and  DX 
registers.  Both  registers  form  a  32-bit  number  which  indicates  the  number  of 
microseconds  to  wait  (1  second  =  1,000,000  microseconds). 

The  CX  register  represents  the  upper  16  bits  of  this  number.  To  calculate  the  total 
time,  the  contents  of  the  CX  register  must  be  multiplied  by  65,536  and  the  DX 
register  must  then  be  added  to  the  total.  If  the  waiting  period  is  known  in 
microseconds,  the  value  for  the  CX  and  the  DX  register  can  be  calculated: 

CX  -  int (Waiting  period  /65,536) 

DX  *  Waiting  period  mod  65,536 
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This  function  can  only  be  called  if  the  previous  call  of  this  function  has  ended  (the 
time  indicated  has  elapsed).  If  this  is  not  the  case,  the  function  returns  immediately 
with  the  carry  flag  set. 

Function  86H:  Wait  for  end  time 

The  second  time  function,  function  86H,  differs  from  function  83H  in  that  it  waits 
until  the  time  indicated  has  elapsed.  For  this  reason  the  frmction  numbor  must  pass 
to  the  AH  register,  and  the  waiting  time  to  the  CX  and  DX  registas  during  the 
function  call.  To  convert  the  waiting  time  into  two  values  for  the  CX  and  DX 
registers,  the  formula  above  can  be  used.  This  function  can  only  be  called  if 
function  83H  was  not  called  ineviously,  and  if  the  time  period  set  during  its  call 
has  not  yet  eUqtsed.  In  such  a  case,  the  function  returns  immediately  with  a  set 
carry  flag  to  die  calling  program. 

Extended  memory 

The  AT  accepts  more  than  640K  of  memory.  This  additional  memory  (called 
extended)  begins  at  1  megabyte  and  cannot  be  accessed  in  real  mode,  in  which  the 
80286  processor  operates  as  an  8086  processor.  Function  88H  determines  the 
availability  and  size  of  this  memory.  Placing  a  value  of  88H  in  the  AH  register 
returns  the  size  of  RAM  beyond  the  1  megabyte  boundary  (excluding  RAM  from  0 
to  640K)  in  IK  increments  in  the  AX  register. 

Function  87H:  Move  memory  block 

Function  87H  moves  blocks  of  memory  within  the  total  memory  space.  This 
means  that  blocks  of  memory  can  be  moved  from  the  area  below  the  1  megabyte 
limit  to  the  area  above  the  1  megabyte  limit,  and  the  other  way  around.  The 
function  should  not  be  used  for  the  l^r,  since  its  call  is  complicated  and  has 
other  disadvantages.  To  access  memory  beyond  the  1  megabyte  barrier,  the 
processor  must  be  switched  into  protected  mode  (full  80286  mode).  Function  87H 
requires  very  comprehensive  information,  since  the  80286  processor  is  more 
difficult  to  program  in  protected  mode  than  in  real  mode  (8086  emulation  under 
DOS).  See  the  end  of  this  section  for  a  {MOgram  which  demonstrates  the  use  of 
function  87H. 

The  function  numb»^  87H  must  first  be  passed  to  the  AH  register,  then  the  number 
of  the  words  to  be  moved  (words  only — ^not  bytes)  must  be  passed  to  the  CX 
register.  A  maximum  value  of  8000H  corre^nds  to  a  maximum  value  of  64K. 

Global  Descriptor  Table 

The  ES:SI  register  pair  receive  the  address  of  the  GDT  (Global  Descriptor  Table), 
which  must  be  installed  in  the  uso*  program.  The  GDT  describes  the  individual 
memory  segm^ts  of  the  80286  in  protected  mode.  The  segments  in  protected 
mode  are  exempt  from  the  limitations  made  in  real  mode.  While  segments  can 
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only  start  at  memory  locations  divisible  by  16  in  real  mode,  protected  mode 
segments  may  start  at  any  memory  location.  Furthermore,  protected  mode 
segments  may  be  any  size  fiom  1  byte  to  64K. 

Another  protected  mode  innovation  is  the  access  code  defined  for  every  segment.  It 
indicates  whethw  the  segment  described  is  a  data  segment  or  a  code  segment  (only 
code  segments  can  be  executed).  The  access  code  also  contains  information  on 
access  priority,  and  whether  access  is  even  permitted.  Every  segment  descriptor 
consists  of  8  bytes  apiece.  Function  87H  expects  during  its  call  that  six  segment 
descriptors  have  been  jx-epared  in  the  GDT  (i.e.,  memory  space  reserved  for  them). 
The  figure  below  illustrates  which  segment  descriptors  are  involved,  as  well  as  die 
construction  of  a  segment  descriptor. 


Segment  descriptor  structure  as  seen  by  function  87H 

Only  the  segment  descriptors  designated  as  start  and  destination  are  of  interest  here, 
since  the  BIOS  functions  fill  out  the  other  descriptors.  The  first  describes  the 
segment  from  which  the  data  are  taken.  The  destination  descriptor  describes  the 
segment  into  which  the  data  are  copied.  The  length  of  both  segments  can  be 
OhFFFH  (64K  decimal),  even  if  fewer  bytes  (or  words)  copy  over  in  the  process.  If 
a  lower  value  is  indicated,  do  not  allow  the  number  of  bytes  (number  of  words 
multiplied  by  2)  to  be  copied  to  exceed  this  amount.  Otherwise  the  processor 
notices  an  access  across  a  segment  boundary  during  copying,  which  triggers  an 
error.  The  address  of  the  two  memory  areas  must  be  converted  to  a  (physical)  24- 
bit  address.  The  lower  16  bits  of  this  address  enter  the  second  field  of  the  segment 
descriptor  and  the  upper  8  bits  enter  the  third  field.  As  access  code  92H  can  be 
used,  which  signals  the  processor  that  the  described  segment  is  a  data  segment  with 
the  highest  priority;  that  the  segment  exists  in  memory;  and  that  the  segment  can 
be  written.  The  last  field  of  the  descriptor  exists  for  reasons  of  compatibility  with 
the  80386  processor,  and  should  always  contain  the  value  0. 

While  the  address  of  the  user  program's  buffer  stays  fixed,  the  address  beyond  the  1 
megabyte  boundary  to  which  data  should  be  copied  can  be  freely  selected  (subject 
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to  RAM  availability).  The  following  table  shows  the  addresses  of  the  various  IK 
blocks  beyond  the  1  meg2d>yte  border  as  24-bit  addresses. 


0  K  =  lOOOOOH 

1  K  =  100400H 

2  K  =  100800H 

3  K  =  lOOCOOH 

4  K  =  lOlOOOH 

5  K  =  101400H 

6  K  =  100800H 

7  K  =  lOOCOOH 

8  K  =  102000H 

9  K  =  102400H 


60  K  =  lOFOOOH 

61  K  =  10F400H 

62  K  =  10F800H 

63  K  =  lOFCOOH 

64  K  =  IIOOOOH 

65  K  =  110400H 

66  K  =  110800H 

67  K  =  llOCOOH 

68  K  =  lllOOOH 

69  K  =  111400H 


124  K  =  IIFOOOH 

125  K  =  11F400H 

126  K  =  11F800H 

127  K  =  llFCOOH 

128  K  =  120000H 

129  K  =  120400H 

130  K  =  120800H 

131  K  =  120C00H 

132  K  =  121000H 

133  K  =  121400H 


252  K  =  13F000H 

253  K  =  13F400H 

254  K  =  13F800H 

255  K  =  13FC00H 

256  K  =  140000H 

257  K  =  140400H 

258  K  =  140800H 

259  K  =  140C00H 

260  K  =  141000H 

261  K  =  141400H 


After  the  function  call  the  carry  flag  indicates  the  success  of  the  function  call.  If 
the  carry  flag  sets,  an  error  occurred.  The  value  in  the  AH  register  indicates  the 
cause  of  the  error: 


AH  =  0 

No  error  (carry  flaq  reset) 

AH  =  1 

RAM  parity  error 

AH  =  2 

GDT  defective  at  function  call 

AH  =  3 

protected  mode  could  not  be  initialized  properly 

A  disadvantage  of  this  function  is  that  while  the  processor  is  in  protected  mode,  all 
interrupts  must  be  suppressed.  The  reason  is  the  fact  that  during  the  protected 
mode,  BIOS  interrupts  (e.g.,  timer  or  keyboard)  can  be  called,  but  these  routines 
were  developed  for  operation  in  real  mode  only.  These  interrupts  may  not  work 
prc^rly  in  protected  mode.  The  disadvantage  can  be  clearly  seen  when  you  call  the 
timer.  Since  its  interrupts  are  suppressed,  protected  mode  performs  no  time 
measurement,  and  time  remains  frozen  for  a  moment.  If  programs  call  function 
87H  frequently,  the  clock  may  run  slow  by  20  or  30  seconds  in  one  day.  The  clock 
can  be  reset  easily  to  the  proper  time  with  software,  so  software  can  bypass  most 
of  the  disadvantages. 

Function  89H:  Protected  mode 

Function  89H  switches  the  AT  into  protected  mode.  Only  someone  developing  his 
own  operating  system  may  have  any  interest  in  this  function.  Any  system  capable 
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of  multiprocessing  must  run  in  protected  mode.  This  function  goes  far  beyond  the 
scope  of  this  book.  See  the  AT  technical  manual  for  more  information. 

Function  84H:  Joystick  reader 

Function  84H  reads  two  joysticks  connected  to  the  AT.  Two  sub-functions  operate 
within  this  function:  Both  return  a  set  carry  flag  if  the  adaptor  to  which  the 
joysticks  should  be  connected  doesn't  exist. 

The  first  sub-function  executes  by  passing  the  function  number  to  the  AH  register 
and  the  value  0  to  the  DX  register.  It  returns  the  status  of  the  joystick  fire  buttons 
in  bits  4  to  7  of  the  AL  register. 

The  second  sub-function  executes  by  passing  the  function  number  to  the  AH 
register  and  the  value  1  to  the  DX  register.  It  returns  current  joystick  positions 
using  X-  and  Y-cocMrdinates.  The  X-coordinate  for  the  first  joystick  can  be  found  in 
the  AX,  and  the  Y-coordinate  in  the  BX  registo*.  For  the  second  joystick,  the  CX 
register  contains  the  X-coordinate  and  the  DX  register  the  Y-coordinate. 

Function  85H:  Read  SysReq  key 

The  <System  Request>  key  on  the  AT  keyboard  triggers  an  interrupt  without 
producing  a  character  code.  It  cannot  be  tested  with  the  BIO^  keyboard  reading 
functions.  Function  85H  reads  the  keyboard  for  the  <System  Request>  key. 
Passing  the  function  number  to  the  AH  register  executes  the  function.  The  current 
BIOS  version  doesn't  implement  this  function  within  the  cassette  interrupt. 
Usually  the  <System  Request>  key  does  nothing  when  the  user  presses  it. 
However,  a  machine  language  routine  can  assign  a  special  application  to  the 
<System  Request>  key.  This  program  must  only  "deflect"  interrupt  15H  to  its 
own  routine.  If  it’s  called  by  a  user  program  or  by  the  system,  a  user  routine 
executes  instead  of  the  cassette  interrupt.  It  can  test  whether  the  AH  register 
contains  the  function  number  8SH.  If  this  is  not  the  case,  it  calls  the  old  cassette 
interrupt.  If  the  AH  register  contains  this  function  number,  the  user  routine 
performs  the  desired  action. 

The  content  of  the  AL  register  is  also  important  to  this  user  routine  because  it 
indicates  whether  the  user  pressed  or  released  the  <System  Request>  key.  0  means 
activated,  1  released. 
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Demonstration  programs 

Of  all  the  functions  made  available  by  this  interrupt,  the  most  interesting  is 
probably  function  88H.  It  permits  the  owners  of  ATs  with  memory  beyond  the  1 
meg  limit  to  use  memory  that  is  inaccessible  to  DOS.  The  programs  i»«sented  in 
this  section  demonstrate  easy  calls  to  function  87H  within  user  programs.  To 
illustrate  the  function  call,  each  one  of  these  programs  copies  the  current  video 
RAM  contents  directly  beyond  the  1  megabyte  memory  border.  It  then  erases  the 
video  RAM  and  restores  it  again.  The  core  of  these  programs  is  always  the  routine 
which  calls  function  88H  of  interrupt  ISH.  It  constructs  a  GDT  fw  this,  enters  the 
addiesss  of  the  start  and  destination  area,  as  well  as  the  GDT.  First  it  converts  the 
two  addresses  (passed  as  segment  and  offset  addresses)  into  a  24-bit- wide  address. 
This  routine  must  be  constructed  flrst  in  assembly  huiguage  for  the  higher  level 
languages,  then  integrated  into  the  tiigha*  level  language  programs.  Youll  see  how 
this  is  done  in  the  documentation  of  the  individual  listings.  To  avoid  detailed 
comparison  of  the  various  assembler  programs  for  linking  into  the  move  function, 
the  dffmence  lies  almost  exclusively  in  the  area  of  the  variable  passing.  Otherwise 
the  programs  are  almost  identical 

BASIC  listing:  MOVE.BAS 

100  **************★♦*★*★***★*★*★***★★★★★★*★*★*★*****★*★★***★*******★★*• 

110  •*  MOVE 

120  •* - *• 

130  Task  ;  uses  the  Routine  for  moving  a  storage  area  *' 

140  '*  to  store  the  Video-RAM 

150  •*  Author  :  MICHAEL  TISCHER 

160  '*  developed  on  ;  7.22.87  *• 

170  •*  last  Update  :  9.21.87  *• 

180  '****'*******************************★***★****'************★********• 

190  • 

200  CLS  :  KEY  OFF 

210  PRINT "WARNING:  This  program  can  only  be  started  if  the  GWBASIC  " 

220  PRINT"was  started  from  the  DOS  level  with  <GWBASIC  /m:60000>" 

230  PRINT  :  PRINT" If  this  is  not  the  case,  input  an  <s>  to  Stop  " 

240  PRINT"Else,  press  any  key..."; 

250  A$  -  INKEY$  :  IF  A$  «  "s"  THEN  END 
260  IF  A$  -  ""  THEN  250 

270  CLS  'Clear  Screen 

280  PRINT"MOVE  (c)  1987  by  Michael  Tischer"  :  PRINT 

290  PRINT"This  Program  uses  Function  87(h)  of  Interrupt  15(h)  to  copy  blocks  " 

300  PRINT"of  memory  between  the  'normal*  RAM  and  the  RAM  beyond  the  " 

310  PRINT"1-Megabyte  border." 

320  DEF  SEG  -  &HF000  'Set  BlOS-segment 

330  IF  PEEK(fiHFFFE)  »  4HFC  THEN  380  'test  if  AT 

340  PRINT"Since  this  unit  is  not  an  AT,  but  a  PC  or  " 

350  PRINT"XT,  and  they  do  not  have  memory  the  1-MB  limit,  " 

360  PRINT"this  program  can  not  be  executed!  Sorry..." 

370  END  'Terminate  Program  (PC  or  XT) 

380  PRINT"The  Program  will  first  copy  the  current  display  immediately  beyond  the  " 
390  PRINT"!  MB  border  and  thens  clear  the  screen.  If  you  then  press  a  key,  " 

400  PRINT"the  old  screen  content  is  restored." 

410  PRINT  :  PRINT"Please  activate  a  key  to  start  the  program..."; 

420  A$  «  INKEYS  :  IF  AS  THEN  420  'wait  for  key 

430  STARTS%  -  VIDEOS%  :  STARTO%  -  0  'Start-area  is  Video-RAM: 0000 

440  GOSUB  60000  'install  Function  for  Interrupt  call 

450  GOSUB  61000  'install  Function  for  copying  memory 

460  GOSUB  50000  'get  current  Video  mode 

470  IF  VMODE%  »  7  THEN  VIDEOS%  -  &HB00O  ELSE  VIDEOS%  -  &HB800 

480  STARTO%  »  0  :  STARTS%  -  VIDEOS%  'Start  address  is  the  Video-RAM 
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490  DESTS%  =  0  :  DESTO%  »  0 
500  DIRECTION%  -  1 
510  SIZE%  -  2000 
520  GOSUB  51000 
530  CLS 

540  PRINT^Please  activate  a  key  . 

550  A$  -  INKEY$  :  IF  A$  -  THEN 

560  STARTS%  -  0  :  STARTO%  »  0 

570  DESTS%  «  VIDEOS%  :  DESTO%  »  0 

580  DIRECTION%  -  2 

590  GOSUB  51000 

600  LOCATE  15,1 

610  END 

620  • 

50000  •**************************< 
50010  '*  Sense  current  Video  Mode 


•destination  area  is  10000:0000 
•copy  from  below  to  above  1  MB 
•the  size  of  the  Video-RAM  is  200  Words 
•move  memory 
•clear  screen 

550  'wait  for  key 

'Start  area  is  10000:0000 
'Destination  area  is  Video-RAM: 0000 
'copy  fran  above  to  below  1  MB 
'move  memory 

'Set  Cursor  to  column  1  of  line  15 


Input :  none 

Output:  VM0DE%  *  the  current  Video  mode 
Info  :  the  Variable  Z%  is  used  as  Dummy 


Z%=15  'get  Function  number  for  Video  mode 

INR%=4H10  'call  BlOS-Video-Interrupt  16(h) 

CALL  lA (INR%, Z%, VMODE%, PAGE%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%) 

RETURN  'back  to  caller 


'*  move  a  memory  area 


•*  Input:  STARTS % 

•  *  STARTO% 

•  *  DESTS% 

•  *  DESTO% 

SIZE% 

• ''  DIRECTION% 

'*  data: 

0 

•*  1 

'*  2 

•*  3 

'*  Output:  none 
•*★*★****★***★★*** 

CALL  MOVE(STARTS%, 
RETURN 


=  segment  address  of  the  Start  area 
=  Offset  address  of  the  Start  area 
“  segment  address  of  the  destination  area 
=  Offset  address  of  the  destination  area 
=  Number  of  words  to  be  moved 
=  Direction  in  which  to  move 

=  from  below  1  MB  — >  to  below  1  MB 
=  from  below  1  MB  — >  beyond  1  MB 
=  from  above  1  MB  — >  below  1  MB 
=  from  beyond  1  MB  — >  beyond  1  MB 


STARTO%, DESTS%, DEST0%, SIZE%,  DIRECTION%) 
•back  to  caller 


****************** 


initialize  the  Routine  for  Interrupt  call  * 

_ * 

Input:  none  * 

Output:  lA  is  the  Start  address  of  the  Interrupt-Routine  * 

************************************************************** 


IA=60000!  'Start  address  of  the  Routine  in  the  BASIC-segment 

DEF  SEG  'Set  BASIC-segment 

RESTORE  60130 

FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'poke  Routine 
RETURN  'back  to  caller 


DATA  85, 
DATA  12, 
DATA  142, 
DATA  138, 
DATA  138, 
DATA  139, 
DATA  28, 
DATA  22, 
DATA  16, 
DATA  88, 
DATA  202, 


,236,  30, 
,  60,139, 
,  139, 118, 
,139,118, 
,139,118, 
,  85,205, 
,  36,139, 
,  28,139, 
,  52,139, 
,118,  6, 
,  0,  91, 


6,139,] 
118,  8,] 

28.138, 

22. 138, 

16.138, 
33,  93, 

118,  26,] 
118,  20,1 
118,  14,] 
137,  4, 

46,136, 


/139,  4, 

,  61,255, 
,118,  26, 
,118,  20, 
,118,  14, 
,139,118, 
,139,118, 
,139,118, 
,139,118, 
,118,  10,; 
,233,108,: 


,140,  0, 

,117,  2, 

,  4,139, 

,  44,139, 
,2  0,139, 
,137,  60, 
,136,  60, 
,136,  12, 
,140,192, 
/  4,  7, 


139,118 
140,216 
118,  24 
118,  18 
118,  10 

139,118 

139,118 

139,118 
137,  4 

31,  93 
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61000 

61010 

61020 

61030 

61040 

61050 

61060 

61070 

61080 

61090 

61100 

61110 

61120 

61130 

61140 

61150 

61160 

61170 

61180 

61190 

61200 

61210 

61220 


I  *************************************************************** ' 

'*  Initialize  Routine  for  moving  of  mremory  areas.  *' 

_  _ _ *• 

•*  Input:  none  *' 

'*  Output:  MOVE  is  the  Start  address  of  the  Routine  *' 

I***************************************************************' 


DEF  SEG 
MOVE=61000! 

RESTORE  61130 

FOR  1%  -  0  TO  140:  READ  BYTE% 
RETURN 


•Set  BASIC  segment 

•Start  address  of  the  Routine 

POKE  MOVE+I%,BYTE%  :  NEXT 
•back  to  caller 


DATA  232,115,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0 

DATA  0,  0,  0,  0,255,255,  0,  0,  16,146,  0,  0,255,255,  0 

DATA  0,  0,146,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0,  0 

DATA  0,  0,  0,  0,  0,  0,  85,139,236,139,126,  6,138,  45,139 
DATA  126,  12,139,  5,139,126,  10,139,  29,246,197,  1,232,  46,  0 
DATA  136,  84,  28,137  68,  26,139,126,  16,139,  5,139,126,  14,139 

DATA  29,246,197,  2,232,  24,  0,136,  84,  20,137,  68,  18,180,135 

DATA  139,126,  8,139,  13,205,  21,139,229,  93,202,  12,  0,  94,235 

DATA  186,138,212,177,  4,210,234,117,  3,128,202,  16,211,224,  3 

DATA  195,115,  2,254,194,195 


The  DATA  statements  integrated  the  interrupt  call  routine  and  the  memory 
movement  routine  into  BASIC.  They  contain  the  machine  language  command 
codes,  read  and  POKEd  into  the  BASIC  section  starting  at  address  61000.  This 
address  is  also  stored  in  the  MOVE  variable  so  that  the  program  can  be  called  from 
the  CALL  command  in  line  51160.  For  those  of  you  who  have  mastered  assembly 
language,  here  is  the  program  listing  from  which  the  DATA  lines  of  the  MOVE 
function  were  derived. 


Assembler  listing:  MOVEBA.ASM 


.**★****★****★*★****★*****★**★★★*★*★***★★★*★★★★**★★*★★★★★*** *********** 
;*  M  0  V  E  B  A  *; 


Task  :  Makes  the  functions  for  moving  of 

memory  blocks  beyond  the  1MB  memory  limit 
available  in  BASIC  for  linking 

* . 

*• 

*  - 

Author  :  MICHAEL  TISCHER 

developed  on  :  8.22.87 

last  Update  :  9.21.87 

★  • 
t 

■kj 

*  . 

_— _*  • 

Info:  the  Code  is  fully  relocatable  so  that  the 

★  • 

Routine  can  be  poked  to  any  place  within  the 

★  . 

BASIC  segment 

*  • 

assembly  :  MASM  MOVEBA; 

★  . 

LINK  MOVEBA; 

★  . 

EXE2BIN  MOVEBA  MOVEBA.COM 

*  • 

.***★*****************★***★*********************************★*********. 


code  segment 

assume  cs : code, ds : code, es : code, ss: code 

; —  MOVE:  Copy  storage  blocks  beyond  the  1MB  limit - - - 

; —  Call  from  BASIC:  CALL  ADR ( Sour cesegment,  StartOffset,  Destsegment, 
; —  DestOffset,  Size,  Direction); 

; —  Info  :  -  after  the  call  Variables  are  in  the  following 
; —  Positions  on  the  Stack: 

; —  Startsegment  -  SP  +  16 

StartOffset  -  SP  +  14 
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t —  Dest segment  =  SP  +  12 

r —  DestOffset  *  SP  +  10 

Size  »  SP  +  8 

! —  Direction  =  SP  +  6 

! —  -  for  Direction  the  following  Codes  are  accepted 

0  =  from  below  1  MB  — >  to  below  1  MB 
! —  1  =  from  below  1  MB  — >  to  over  1  MB 

; —  2  »  from  above  1  MB  — >  to  below  1  MB 

r —  3  *  from  above  1  MB  — >  to  above  1  MB 

! —  -  the  number  concerns  words  not 

/■ —  bytes,  and  can  not  be  larger  than  8000(h) 

move  proc  far  ;GW  expects  during  CALL  Far-Procedure 

call  get_adr  ;the  Address  of  the  Routine 

; —  The  Global  Descriptor  Table  - 

GDT  equ  this  word 

dw  4  dup  (?)  /segment  Descriptors  for  Duirany-segment 

dw  4  dup  (?) 

segment  Descriptors  of  the  Source-Area  - 

dw  Offffh  /segment  length  *  64  KB 

dw  (?)  /Lo-Word  of  the  24  bit-Address 

db  OlOh  /Hi-Byte  of  the  24  bit-Address 

db  10010010b  /Data  segment  in  memory  with 

/highest  priority,  Writeable 
dw  OOOOOh  /Compatibility  Word  for  80386 

segment  Descriptors  of  the  Destination-Area  - 

dw  Offffh  /segment  length  =  64  KB 

dw  (?)  /Lo-Word  of  the  24  bit-Address 

db  (?)  /Hi-Byte  of  the  24  bit-Address 

db  10010010b  /Data  segment  in  memory  with 

/highest  priority,  Writeable 
dw  OOOOOh  /Compatibility  Word  for  80386 

dwx4  dup  (?)  /segment  Descriptors  BlOS-Code-segment 

dw  4  dup  (?)  /segment  Descriptors  Stack-segment 

/ —  the  Code  of  the  MOVE-Routine  - 

movel:  push  bp  /store  GW  Basepointer 

mov  bp, sp  /move  SP  to  BP 

mov  di, [bp+6] 

mov  ch, [di] 

mov  di, [bp+12] 

mov  ax,  [di] 

mov  di,  [bp+10] 

mov  bx, [di] 

test  ch, 1 
call  calc_adr 

mov  [si+da_hi-gdt] , dl  /store  result 
mov  [ s i +da_l  o-gdt ] , ax 

mov  di, [bp+16]  /get  address  of  the  Startsegment -Variable 

mov  ax, [di]  /move  Source  segment  address  to  mov 

mov  di, [bp+14]  ;get  Address  of  StartOff set -Variable 

mov  bx, [dl]  /Source  Offset  address  to  BX 

test  ch,  2  /is  Source  beyond  ,1  MB? 

call  calc_adr  /form  24  bit  Address 

mov  [si+sa_hi-gdt] ,dl  /store  result 

mov  [si+sa_lo-gdt] ,ax 

mov  ah, 087h  /Parameter  for  the  Function  call 

mov  di, [bp+8]  /get  Address  of  the  Size-Variables 

mov  cx, [di]  /get  number  of  words 

int  15h  /call  RAM-displacement  function 


/get  Address  of  the  direction  Variable 
/move  direction  to  CH 
/get  Address  of  Dest segment -Variable 
/move  destination  segment  address  to  AX 
/get  address  of  DestOffset -Variable 
/move  destination  Offset  address  to  BX 
/Destination  beyond  1  MB? 

/form  24  bit  Address 


sa_lo 
sa  hi 


da_lo 
da  hi 
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mov 

sp/bp 

; restore  Stackpointer 

pop 

bp 

;  ret  urn  BP  frcxn  the  Stack 

ret 

12 

/Addresses  of  the  Variables  on  the  Stac 

;are  no  longer  required 

Move 

endp 

GET  ADR: 

returns  the 

Offset  address  of  the  GDT  - - - 

; —  Input 

: 

none 

; —  Output  : 

SI  -  Offset 

address  of  the  GDT 

; —  Register  : 

SI  is  changed 

get_adr 

proc 

near 

pop 

si 

;get  Address  of  GDT  frcxn  Stack 

jmp 

short  movel 

/jump  to  actual  Routine 

get_adr 

endp 

CALC  ADR: 

calculates 

the  24  bit  (physical)  Address  - 

; —  Input 

: 

AX:BX  =  Buffer  address  to  be  converted 

; — 

Zero  Flag  » 

1  :  Buffer  address  beyond  1  MB 

;  —  Output  : 

DL  =  HI-Byte  of  Buffer  address  (bit  16-23) 

7 

: 

BX  =  Lo-Word  of  Buffer  address  (bit  0-15) 

; —  Register  : 

AX,  BX,  DL, 

CL  and  FLAGS  are  changed 

calc_adr 

proc 

near 

mov 

dl,ah 

/Hi-Byte  of  the  segment  address  to  DL 

mov 

cl,  4 

/move  Hi-Nibble  of  the  segment 

shr 

dl,cl 

/address  to  the  Lo-Nibble 

jne 

under_lmb 

/test  if  beyond  1  MB 

or 

dl,010h 

/is  beyond  1  MB 

under  Imb 

:shl 

ax,  cl 

/segment  address  times  16 

add 

ax,bx 

/add  Offset  address 

jnc 

nojnore 

/test  if  excess 

inc 

dl 

/yes 

no  more: 

ret 

/back  to  caller 

calc_adr  endp 


code  ends 

end 

The  INLINE  command,  not  DATA  statements,  integrate  the  MOVE  routine  into 
the  following  Pascal  program. 

Pascal  listing:  MOVEP.PAS 

^ ★*★★★****★*****★★★****★★****★★*****★******★★****★★*****★★***********★} 


{*  M  0  V  E  P  *} 

(* - 

{*  Task  :  With  the  help  of  a  procedure.  Data  are  *} 

{*  copied  in  RAM  below  and  above  1  MB  *} 

- 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  on  :  8/8/87  *} 

last  Update  :  6/8/89 

- *} 

i*  Info  :  This  program  runs  only  on  ATs  and  *} 

only  if  RAM  beyond  1  MB  *} 
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I*  is  available  *} 

program  MOVEP; 


Uses  Crt,  Dos;  {add  Crt  and  Dos  units} 

var  Keypress  :  char; 

{**★***★************************«*** ********************************** I 

{*  GETPAGE:  returns  the  segment  address  of  the  current  display  page  *} 
{*  Input  :  none  *} 

{*  Output  :  the  segment  address  of  the  current  display  page  *} 

I  *★***★****★★***★***★***»**★******★********<,»**,***<,********★***★*****  j 

function  Get Page  :  Longint; 


var  Regs  :  Registers; 


{Processor  registers  for  interrupt  calls} 


begin 

Regs. ah  :=  15; 
intr($10,  Regs); 
if  Regs.al  *  7  then  Get Page 
else  GetPage 


end; 


$B000 

$B800; 


{  Function  number  } 
{  Call  BIOS  video  interrupt  } 
{  Monochrcxne  card  } 
{  Color  card  } 


MOVE:  moves  memory  areas 

Input  :  see  below 
Output  :  none 
Info:  Direction: 


0  =  from  below  1  MB — >  to  below  1  MB  *} 

1  =  from  below  1  MB — >  to  above  1  MB  *} 

2  =  from  above  1  MB — >  to  below  1  MB  *} 

3  =  from  above  1  MB — >  to  above  1  MB  ,  *} 

Addresses  above  the  1MB  boundary  are  given  relative  *} 
to  this  value  *} 

****** ***1Hf********************************************* I 


{$F+} 

procedure  HlMove (StartSeg, 
StartOfs, 

DestSeg, 

DestOfs, 

Size, 

Direction  :  integer) ; 

begin 
inline ( 


{  Segment  address  of  the  start  buffer  } 
{  Offset  address  of  the  start  buffer  } 
{  Segment  address  of  destination  buffer  } 
{  Offset  address  of  destination  buffer  } 
{  Number  of  words  to  be  copied  } 
{  Direction  in  which  to  copy  } 


$8B/$7E/$10/$8B/$76/$0E/$8B/$46/$0C/$8E/$C0/$8B/$5E/$0A/ 

$8B/$46/$08/$8B/$4E/$06/$8A/$E9/$55/$E8/$5E/$00/$00/$00/ 

$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/ 

$FF/$FF/$00/$00/$10/$92/$00/$00/$FF/$FF/$00/$00/$00/$92/ 

$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/ 

$00/$00/$00/$00/$50/$8C/$C0/$F6/$C5/$01/$E8/$28/$00/$2E/ 

$88/$56/$lC/$2E/$89/$46/$lA/$8B/$C7/$8B/$DE/$F6/$C5/$02/ 

$E8/$16/$00/$2E/$88/$56/$14/$2E/$89/$46/$12/$B4/$87/$0E/ 

$07/$59/$8B/$F5/$CD/$15/$EB/$17/$5D/$EB/$CF/$8A/$D4/$Bl/ 

$04/$D2/$EA/$75/$03/$80/$CA/$10/$D3/$E0/$03/$C3/$73/$02/ 

$FE/$C2/$C3/$5D 


end; 


); 


(*********************************************************************} 
{*  MAIN  PROGRAM  *} 

^ ********************************************************************* ^ 

begin 

clrscr;  {  Clear  Screen  } 

writeln ('MOVEP  (c)  1987  by  Michael  Tischer'); 

writeln (#13110 'This  Program  uses  Function  87(h)  of  '+ 
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•Interrupt  15(h)  to  move  blocks  of  storage  '); 
writeln( 'between  the  "normal"  RAM  and  the  RAM  beyond  the  1  Mega-'  + 
•Byte  storage  boundary'); 

if  mem[$F000:$FFFE]  <>  $FC  then  {  test  if  computer  is  an  AT  } 

begin 

writeln (' Since  this  computer  is  not  an  AT,  '+ 

' but  a  PC  or ' )  ; 

writeln  ('an  )CT,  and  these  can  not  have  storage  '  + 

'  beyond  the  1  BdB  boundary, ' ) ; 
writeln  ('this  program  can  not  execute  on  your  PC!  '); 
writeln ( ' Sorry. ...'); 
end 
else 
begin 

writeln ('First  this  display  page  is  moved  immediately  '+ 

'beyond  the  1  MB  storage  '); 
writeln ('boundary.  The  screen  is  then  cleared.  '+ 

'After  a  key  has  been  activated,  •); 
writeln ('the  old  display  page  is  restored.'); 
writeln (' 'flSflO' Please  activate  a  key  now  to  '+ 

' start  the  program. . . ' ) ; 

repeat  until  keypressed;  {  Walt  for  a  key  } 

Keypress  :=  ReadKey;  {  Read  key  } 

HiMove(GetPage, $0000, $0000, $0000, $2000,$!);  {  Copy  video  RAM  } 

clrscr;  {  Clear  screen  } 

writeln ( ' Please  press  a  key  ...'); 

Keypress:-  ReadKey;  {  Read  key  } 

HiMove ($0000, $0000, GetPage, $0000, $2000, $2);  {  Restore  video  RAM  } 

gotoxy(l,15) ; 
writeln ( ' That ' s  All !  • ) ; 
end; 
end. 


For  the  Pascal  programmers  interested  in  assembly  language,  the  assembler  listing 
of  the  MOVE  function  appears  here. 


;  ==  Code-segment 

code  segment  para  'CODE'  ; Definition  of  the  CC®E-segment 

org  lOOh  ;it  begins  at  Address  100(h) 

; directly  behind  the  PSP 

assume  cs:code,  dsicode,  es:code,  ss:code 


; — Call :  HiMoves (StartSeg, 
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StartOfs, 

—  DestSeg, 

DestOfs, 

NumWords, 

Direction  :  word) ; 

—  This  routine  is  designed  as  a  FAR  call  model 


movepa 

proc 

near 

s frame 

St  rue 

/Access  structure  on  stack 

bptr 

dw  ? 

/Taken  by  BP 

ret_adr 

dd  ? 

/Return  address  (FAR) 

dlrectn 

dw  ? 

/Copy  direction 

numwords 

dw  ? 

/Number  of  Words  being  copied 

destofs 

dw  ? 

/Destination  buffer's  offset  address 

destseg 

dw  ? 

/Destination  buffer's  segment  address 

startofs 

dw  ? 

/Starting  buffer's  offset  address 

startseg 

dw  ? 

/Starting  buffer's  segment  address 

s  frame 

ends 

/End  of  structure 

frame 

equ  [ 

bp  -  bptr  1 

/For  stack  addressing 

push  bp 

/Store  BP  on  the  Stack 

mov 

bp,  sp 

/Move  SP  to  BP 

mov  di, frame. startseg  ;Get  source  segment  from  stack 
mov  si, frame. startofs  ;Get  source  offset  from  stack 
mov  ax, frame. destseg  ;Get  destination  segment  from  stack 
mov  es,ax  ;and  move  to  ES 

mov  bx, frame. destseg  ;Get  destination  offset  from  stack 

mov  ax,  frame,  numwords  ,-Get  numwords  from  stack 

mov  cx, frame. direct n  ;Get  direction  from  stack 

mov  ch, cl  ;and  send  to  CH 

push  bp  ;Mark  BP 

call  getgdt  ;Determine  address  of  GDT 

; —  Variables  and  Data  of  the  MOVE-Function  - 

GDT  equ  this  word 

THIS  IS  THE  GDT  (GLOBAL  DESCRIPTOR  TABLE)  - 

dw  4  dup  (?)  ; segment  Desc.  for  Dummy-segment 

; —  this  segment  Descriptor  describes  the  GDT  itself  - 

dw  4  dup  (?) 

; —  segment  Descriptor  of  the  Source-Area - - 

dw  Offffh  ; segment  length  =  64  KB 

sa_lo  dw  (?)  ;Lo-Word  of  the  24  bit-Address 

sa_hi  db  OlOh  ;Hi-Byte  of  the  24  bit-Address 

db  10010010b  ,*Data  segment  in  storage  with 

;highest  Priority,  Writeable 
dw  OOOOOh  /Compatibility  Word  for  80386 

; —  segment  Descriptor  of  the  Destination-Area  - 

dw  Offffh  /segment  length  =  64  KB 

da_lo  dw  (?)  /Lo-Word  of  the  24  bit-Address 

da_hi  db  (?)  /Hi-Byte  of  the  24  bit-Address 

db  10010010b  /Data  segment  in  storage  with 

/highest  Priority,  Writeable 
dw  OOOOOh  /Compatibility  Word  for  80386 

/ —  this  segment  Descriptor  describes  the  BlOS-Code-segment 
dw  4  dup  (?) 

/ —  this  segment  Descriptor  describes  the  Stacksegment  - 

dw  4  dup  (?) 

/—  END  OF  THE  GDT - 

/ —  MOVE:  Moves  Data  between  memory  above  and  below  1  MB  - 

/ —  Input  :  DI:SI  =  Source  address  (if  above  1  MB  as  Offset  to  1  MB) 

; —  ES:BX  =  Dest,  address  (if  above  1  MB  as  Offset  to  1  MB) 

/ —  CH  =  move  ...  from  — >  to 

/ —  00b  =  from  below  1  MB  — >  to  below  1  MB 

/ —  01b  =  from  below  1  MB  — >  to  above  1  MB 
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lOb  =  from  above  1  MB  — >  to  below  1  MB 
11b  *  from  above  1  MB  — >  to  above  1  MB 

—  AX  =  Number  of  words  to  be  raove|i  (max.  OBOOOh) 

—  Output  ;  Carry-Flag  =  1  :  Error 

~  Register  ;  AX,  BX,  DL,  CL,  SI,  ES  and  FLAG  are  changed 

—  Info  :  This  function  should  not  be  used  to  move  RAM  below  the 

1-MB  boundary 

/Store  number  of  words  on  the  Stack 
/Destination  segment  address  to  AX 
;is  destination  above  1  MB? 

/form  24  bit  Address 
/store  result 


push  ax 

mov  ax,  es 

test  ch,  1 

call  calc_adr 

mov  cs: [bp+28]  ,dl 

mov  cs: [bp+26] ,ax 

mov  ax, di 

mov  bx, si 

test  ch, 2 

call  calc_adr 

mov  cs: [bp+20],dl 

mov  cs: [bp+18] ,ax 

mov  ah, 087h 

push  cs 

pop  es 

pop  cx 

mov  si, bp 

int  15h 

jmp  short  ende 


/Source  segment  address  to  AX 
/Source  Offset  address  to  BX 
/is  Source  above  1  MB? 

/form  24  bit  Address 
/store  result 

/load  Parameter  for  function  call 
/set  ES  to  CS 

/Get  number  of  Words  from  Stack 
/load  Offset  address  of  (3DT 
/call  RAM  moving  function 
/back  to  Turbo 


movepa  endp 

/ —  GETGDT:  Get  Address  of  the  GDT  and  jump  to  MOVE  - 

/ —  Input  :  none 

/ —  Output  :  CS:BP  =  Address  of  the  GDT 
/ —  Register  :  only  BP  is  changed 

/ —  Info  :  this  Routine  can  only  be  used  in  the  environment 
/ —  of  this  Program 

getgdt  prcc  near 

pop  bp  /Get  Address  of  GDT  from  the  Stack 

jmp  short  move  /Juirp  to  MOVE- Routine 

getgdt  endp 

r 

; —  CALC_ADR:  calculates  24  bit  (physical)  Address  - 

/ —  Input  :  AX:BX  =  Buffer  address  to  be  converted 
/ —  Zero  Flag  =  1  :  Buffer  address  beyond  1  MB 

/ —  Output  :  DL  *  HI-Byte  of  the  Buffer  address  (bit  16-23) 

/ —  :  BX  «  Lo-Word  of  the  Buffer  address  (bit  0-15) 

/ —  Register  :  AX,  BX,  DL,  CL  and  FLAGS  are  changed 

calc_adr  proc  near 


mov 

mov 

shr 

jne 

dl,ah 
cl,  4 
dl,cl 
under__lmb 

/Hi-Byte  of  segment  address  to  DL 
/shift  Hi -Nibble  of  segment 
/address  into  Lo-Nibble 
/test  if  above  1  MB 

or 

dl, OlOh 

/is  above  1  MB 

under_lmb : shl 
add 
jnc 

ax,  cl 
ax,bx 
no_more 

/segment  address  times  16 
/add  Offset  address  to  it 
/test  if  overflow 

inc 

dl 

/yes 

no_more;  ret 

/back  to  caller 

calc_adr  endp 
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ende  label  near  /Code  stops  here 

pop  /Restore  BP  frcxn  atack 


End 


code  ends  /End  of  the  CCX)E  segment 

end  movepa  /End  of  the  assonbler  program 

The  C  program  differs  from  the  BASIC  and  Pascal  programs  in  that  the  MOVE 
function  is  also  present  as  an  assembler  routine,  but  excluded  from  the  C  program 
listing.  First  the  MOVE  assembler  program  assembles,  then  the  C  program  is 
compiled.  You  then  merge  the  two  programs  using  the  linker.  For  this  reason  the 
listing  of  the  C  program  follows  with  the  source  listing  of  the  corresponding 
assembler  function. 


C  listing:  MOVEC.C 

/■k-k  *************11*  ******************************************  **********/ 


/*  M  0  V  E  C  */ 

/*  Task:  integrates  an  Assembler-Routine  in  C,  which  can  */ 

/*  move  memory  blocks  beyond  the  1  MB  boundary  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  developed  on  :  8.13.87  */ 

/*  last  Update  :  9.21.87  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  MSC  MOVEC/  */ 

/*  LINK  MOVEC  MOVECA  PEPO/  */ 

/*  Call  :  MOVEC  */ 

/* - - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation:  with  Project-File  with  the  following  content:  */ 

/*  movec  */ 

/*  moveca.obj  */ 


f  ***************************  kk-k-kk-kk*  **********************************  / 


♦include  <dos.h> 
♦include  <io.h> 
♦include  <conio.h> 

extern  void  AdMoveO/ 
extern  int  PeekB()/ 


/*  include  Header-Files  */ 


/*  ADMOVE  must  be  linked  */ 
/*  PEEKB  must  be  linked  */ 


/****************** ******k** ****************************************** / 

/*  GETPAGE/  returns  the  Address  of  the  current  display  page  */ 

/*  Input  :  none  */ 

/*  Output  :  see  below  */ 

/****************** ******k** ****************************************** / 


unsigned  int  GetPAgeO 

{ 

union  REGS  Register/  /*  Register-Variable  for  Interrupt  call  */ 

Register. h. ah  =  15/  /*  Function  number  to  get  Video  parameter  */ 

int86(0xl0,  &Register,  &Register) /  /*  Call  Interrupt  10(h)  */ 

return ( (Register. h.al  ==  7)  ?  OxBOOO  :  0xB800) / 

} 

/*********************************************************************/ 
/*  CLS  :  Clear  Screen  */ 

/*  Input  ;  none  */ 

/*  Output  :  none  */ 
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/*★*★★***★ ****************** ****★*★★ *********************** ***********/ 
void  Cls() 


{ 

union  REGS  Register;  /*  Register-Variable  for  Interrupt  call  */ 


Register.h.ah 
Register. h.al 
Register.h.bh 
Register.x.cx 
Reglster.h.dh 
Register.h.dl 


6; 

0; 

7; 

0; 

24; 

79; 


int86(0xl0,  fiRegister, 


/*  Function  number  for  Scroll-UP 
/*  0  is  for  clear 
/*  white  characters  on  blade  background 
/*  upper  left  display  corner 
/*  Coordinates  of  the  lower 
/*  right  display  corner 
^Register};  /*  Call  BlOS-Video-Interrupt 


} 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


/*********************************************************************/ 
/**  MAIN  PROGRAM  **/ 

/*********************************************************************/ 


void  mainO 

{ 

printf  ("NnMOVE  (c)  1987  by  Michael  Tischer\n\n'*) ; 
printfC'This  Program  uses  the  Function  87(h)  of  Interrupt  15(h)"); 
printf("  to  move  memory  blocks\nbetween  the  \"normal\"  RAM  and  the  "); 
printfC'RAM  beyond  the  1  Mega-Byte  storage  limit. \n"); 
if  (Peeks (OxFOOO,  OxFFFE)  !=  OxFC)  /*  test  if  AT  */ 

{ 

printf ("Since  this  PC  is  not  an  AT,  but  a  ") ; 
printfC'PC  or  XTNnand  this  PC  can  not  have  RAM  "); 
printf ("beyond  the  1  MB  storage  limit,  "); 
printf ("this  program  can  not  be  executed!  Sorry. . .\n\n") ; 

} 

else 

{ 

printf  ("After  starting  the  program  by  pressing  a  key  "); 

printf ("the  current  displayXn  content  is  "); 

printf ("copied  directly  beyond  the  1  MB-limit\n  ") ; 

printf ("and  then  the  display  is  cleared.  If  another  key  is  "); 

printf  ("\npressed  ,the  old  display  is  again  "); 

printf ("restored. \n\nPlease  press  a  key  to  ") ; 

printf  ("start  the  Program  ..."); 

getchO;  /*  wait  for  a  key  */ 

/* —  Copy  current  Video  Rrm  beyond  1  MB - */ 

AdMove (Get Page  0  ,  0x0000,  0x0000,  0x0000,  0x2000,  1) ; 

Cls();  /*  Clear  Screen  */ 

printf ("\nPlease  press  a  key  ..."); 

getchO;  /*  get  a  key  */ 

/* —  Restore  Video-RAM - */ 

AdMove (0x0000,  0x0000,  GetPage(),  0x0000,  0x2000,  2); 
printf ("\n\nThat' s  It!\n"); 

} 


Assembler  listing:  MOVECA.ASM 

.********************************************************************* 
;*  M  O  V  E  C  A  *, 

;* _ * 

;*  Task  :  Makes  the  Functions  for  moving  of 

;*  Storage  blocks  beyond  the  1MB  memory  limit 

;*  available  for  inclusion  in  C  *, 


Author  :  MICHAEL  TISCHER 
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developed  on 
last  Update 


8.13.87 

9.21.87 


assembly  :  MASM  MOVECA;  * 

**★**★★* A******************************************-*************** 


IGRCXJP  group  _text  /Grouping  of  Program- segments 

DGROUP  group  const, _bss,  _data  /Grouping  of  Data-segraents 

assume  CSiIGROUP,  DS: DGROUP,  ES: DGROUP,  SS: DGROUP 


public 


AdMove  /Functions  beccane  accessible  to  other 
/programs 


CONST 

CONST 

segment 

ends 

word  public  'CONST' 

/this  segment  accepts  all 
/readable  Constants 

BSS 

_BSS 

segment 

ends 

word  public  'BSS' 

/this  segment  accepts  not  all 
/initialized  static  Variables 

_DATA 

segment 

word  public  'DATA* 

/all  initialized  global  and 
/static  Variables  are  stored  in  this 

/ segment 

GDT 

equ  this  word 

/the  Global  Descriptor  Table 

dw  4 
dw  4 

dup  (?) 
dup  (?) 

/segment  Desc.  for  Dummy-segment 

sa_lo 
sa  hi 


/ —  segment  Descriptors  of  the  Source-Area  - 

dw  Offffh  /segment  length  =  64  KB 

dw  (?)  /Lo-Word  of  the  24  bit-Address 

db  OlOh  /Hi-Byte  of  the  24  bit-Address 

db  10010010b  /Data  segment  in  storage  with 

/highest  Priority,  Writeable 
dw  OOOOOh  /Conpatibility  word  for  80386 


/ —  segment  Descriptors  of  the  Desti nation- Area 


da_lo 
da  hi 


dw  Offffh  /segment  length  »  64  KB 

dw  (?)  /Lo-Word  of  the  2 4-bit -Address 

db  (?)  /Hi-Byte  of  the  24-bit-Address 

db  10010010b  /Data  segment  in  storage  with 

/highest  Priority,  Writeable 
dw  OOOOOh  /Compatibility  word  for  80386 

dw  4  dup  (?)  /segment  Desc.  BlOS-Code-segment 

dw  4  dup  (?)  /segment  Descriptors  Staclc-segment 


DATA  ends 


_TEXT  segment  byte  public  'CODE*  /the  Program  segment 


-  ADMOVE:  Copy  Storage  Blocks  beyond  the  1MB  limit - ^ - 

-  Call  of  C:  AdMove (St art segment ,  StartOffset,  Destsegment, 

DestOffset,  Size,  Direction)/ 

-  Info  :  -  for  DIRECTION  the  following  Codes  are  accepted: 

0  =  from  below  1  MB  — >  to  below  1  ME 

1  =  from  below  1  MB  — >  to  above  1  MB 

2  =  from  above  1  MB  — >  to  below  1  MB 

3  “  from  above  1  MB  — >  to  above  1  MB 

-  the  number  relates  to  words,  not  Bytes 
and  can  not  be  larger  than  8000 (h) 

-  for  moving  of  RAM  below  the  1-MB  border 
the  Functions  MOVEDATA  or  MEMCPY  should 
be  called 


_AdMove  proc  near 

push  bp 
mov  bp, sp 
push  si 


/store  BP  on  the  Stack 
/move  SP  to  BP 
rC  exnects  unchanaed  SI 


352 


Abacus 


7.10  The  Cassette  Interrupt 


mov 

ch, [bp+141 

/move  Direction  to  CH 

mov 

ax, [bp+8] 

/Destination  segment  address  to  AX 

mov 

bx, [bp+lO] 

/Destination  Offset  address  to  BX 

test 

ch,l 

/is  Destination  beyond  1  MB? 

call 

calc  adr 

/form  24  bit  Address 

mov 

da_hi,dl 

/store  result 

mov 

da_lo,ax 

mov 

ax, [bp+4] 

/Source  segment  address  to  AX 

mov 

bx,  [bp+6] 

/Source  Offset  address  to  BX 

test 

ch,  2 

/is  Source  beyond  1  MB? 

call 

calc  adr 

/form  24  bit  Address 

mov 

sa_hi,dl 

/store  result 

mov 

sa  lo,ax 

mov 

ah,087h 

/Parameter  for  the  Function  call 

push 

ds 

/load 

pop 

es 

/St  ES  to  DS 

mov 

cx, [bp+12] 

/get  number  of  Words 

mov 

si, offset  DGROUPrGDT 

/load  Offset  address  of  GDT 

Int 

15h 

/call  RAM  moving  functions 

pop 

si 

/restore  old  SI  frcxn  Stack 

mov 

sp,bp 

/restore  Stackpointer 

pop 

bp 

/get  BP  from  Stack 

ret 

/Return  to  calling  C-Program 

AdMove  endp 

' —  CALC_ADR:  calculates  24  bit  (physical)  Address - 

’ —  Input  :  AX:BX  =  Buffer  address  to  be  converted 
■ —  Zero  Flag  =  1  ;  Buffer  address  beyond  1  MB 

' —  Output  :  DL  =  HI-Byte  of  the  Buffer  address  (bit  16-23) 
f —  :  BX  =  Lo-Word  of  the  Buffer  address  (bit  0-15) 


/ —  Register  : 

AX,  BX,  DL, 

CL  and  FLAGS  are  changed 

calc_adr  proc 

near 

mov 

mov 

shr 

jne 

dl,ah 
cl,  4 
dl,cl 
under_lmb 

/Hi-Byte  of  segment  address  to  DL 
/move  Hi -Nibble  of  segment  address 
/into  the  Lo-Nibble 
/test  if  beyond  1  MB 

or 

dl,010h 

/beyond  1  MB 

under_lmb : shl 
add 
jnc 

ax,  cl 
ax,bx 
nojnore 

/segment  address  times  16 
/add  Offset  address 
/test  if  overflow 

inc 

dl 

/yes 

no_more:  ret 

/back  to  caller 

calc_adr  endp 

f 

_text  ends 

/End  of  the  Program-segment 

end  ;End  of  the  Assembler-Source 


353 


7.  The  BIOS 


PC  System  Programming 


Here  is  the  assembler  program.  No  additional  program  code  is  required  for 
integrating  the  MOVE  function  because  it  is  built-in. 

Assembler  listing:  MOVEA.ASM 


***************  Ic-k-k-k-k-klfkifk-k-klfk-k-k-k-k-klftfkifkifkiclfkitifkifkitifk-kifkie-kiele-k-kie-kie-kie-kie-k* 


★ 

MOVEA 

★  • 

* 

Task  :  copies  data  between  RAM  below  1  MB  and 

-k  - 

★ 

*  _ 

above 

1  MB 

★  • 

★ 

Author  : 

MICHAEL  TISCHER 

★ . 

* 

developed  on  : 

6.8.87 

* 

* _ 

last  Update  : 

9.21.87 

* . 

* 

assembly  : 

MASM  MOVEA/ 

*; 

★ 

LINK  MOVEA/ 

*  • 

* 

.  ★ _ 

EXE2BIN  MOVEA  MOVEA.COM 

★ . 

_ _ *» 

♦Call  :  MOVEA  *; 

*********** *******it** ************************************************ • 


;  ==  BIOS- segment  =====================*============.=================== 

bios  segment  at  OFOOOh  ;used  for  Addressing  of  the 

; Device-Codes 

org  OFFFEh  ;Address  of  the  Device-Codes  in  BIOS 

gercode  equ  this  byte 

bios  ends  ;End  of  the  BlOS-segments 

code  segment  para  'CODE*  /Definition  of  the  CODE-segment 

org  lOOh  ;it  begins  at  Address  100(h) 

/directly  after  the  PSP 

assume  cs:code,  ds:code,  esrblos,  ss:code 

/  ==  Program  =============================================»=========== 


movea  proc  near 


/ —  Output  Initiation  Message 


mov  dx, offset  initm 
mov  ah, 9 

int  21h 


/Offset  address  of  the  Init  message 
/output  Function  number  for  String 
/Call  DOS- Interrupt 


mov 

mov 

cmp 

je 


ax, OFOOOh 
es,ax 

es: gercode, OFCh 


/segment  address  of  BIOS 
/to  ES 

/is  the  device  an  AT 


isat  /YES  — >  continue  to  execute  Program 


/ —  Device  is  PC  or  XT,  Program  doesn't  run 


mov  dx, offset  sorrym  /Offset  address  of  Text 

jmp  short  pcxt  /Output  message  and  terminate  program 


isat : 


/ —  User  must  activate  a  key  to  start  the  program 


mov  dx, offset  dom  /Offset  address  of  the  Text 

mov  ah,  9  /output  function  number  for  String 

int  21h  /call  DOS-Interrupt 


xor  ah,  ah 


/read  a  character  from  the  keyboard 
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int  16h 


/call  BIOS-Keyboard-Interrupt 


Move  Vldeo-RAM 

to  1  MB  - 

call 

getvseg 

/Get  segment  address  of  Vldeo-RAM 

mov 

dl,ax 

/and  move  to  DI 

xor 

si, si 

/copy  starting  at  Offset  address  0 

xor 

bx,bx 

/copy  after  1MB  +  0000:0000 

mov 

es,bx 

mov 

ch,l 

/from  below  1  MB  to  above  1  MB 

mov 

ax, 2000 

/move  2000 

call 

move 

/Words 

jc 

fehler 

/on  error  terminate 

; —  Fill  Vldeo-RAM  with  characters  - 

call 

getvseg 

/Get  segment  address  of  the  Vldeo-RAM 

mov 

es,ax 

/and  move  to  ES 

xor 

dl,dl 

/start  at  Offset  address  0 

mov 

cx,2000 

/fill  the  conplete  Vldeo-RAM  with 

mov 

ax, 87FEh 

/blinking  Block-Character 

rep 

stosw 

; —  User  must  activate  a  key  - 

mov 

dx, offset  userm  /Offset  address  of  the  Text 

mov 

ah,  9 

/output  function  number  for  String 

Int 

21h 

/call  DOS-Interrupt 

xor 

ah,  ah 

/read  a  character  from  the  keyboard 

Int 

16h 

/call  BIOS-Keyboard-Interrupt 

Restore  Video- 

RAM  again  - 

xor 

dl,dl 

/restore  1  MB  +  0000:0000 

xor 

si, si 

xor 

bx,bx 

mov 

ch, 10b 

/from  beyond  1  MB  to  below  1  MB 

mov 

ax, 2000 

/move  2000 

call 

move 

/Words 

jc 

fehler 

/terminate  on  error 

mov 

ax, 4C00h 

/terminate  Program  with  call  of  a  DOS 

Int 

21h 

/function  on  return  of  Error-Code  0 

error:  i 

mov 

dx, offset  errm 

/Offset  address  of  error  message 

pcxt : 

mov 

ah,  9 

/output  function  number  for  String 

Int 

21h 

/call  DOS-Interrupt 

mov 

ax,4C01h 

/terminate  Program  with  call  of  a  DOS 

Int 

21h 

/function  on  return  of  Error-Code  1 

movea 

endp 

; —  GETVSEG  : 

returns  the  segment  address  of  the  Vldeo-RAM  - 

; —  Input 

: 

none 

; —  Output  : 

AX  =  segment 

address  of  the  Vldeo-RAM 

; —  Register  : 

AX,  BH  and  FLAGS  are  changed 

getvseg 

proc 

near 

mov 

ah, OFH 

/get  function  number  for  Video 

Int 

lOh 

/call  BlOS-Vldeo-Interrupt 

anp 

al,7 

/Is  a  Mono-Card  Installed? 

jne 

colvldeo 

/NO  — >  Color-Card 

mov 

ax,  OBOOOh 

/segment  addr.  of  the  mono  Vldeo-RAM 

ret 

/back  to  caller 

col video: 

mov 

ax, OBSOOh 

/segment  addr.  of  color  Vldeo-RAM 
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ret 

getvseg  endp 


;back  to  caller 


—  MOVE:  Moves  Data  between  Storage  above  and  below  1  MB  - 

—  Input  :  DI:SI  =  Sourceaddress  (if  above  1  MB  as  Offset  to  1  MB) 

—  ES:BX  =  Dest  address  (if  above  1  MB  as  Offset  to  1  MB) 

—  CH  =  move  . . .  from  — >  to 

00b  =  from  below  1  MB  — >  to  below  1  MB 

01b  =  from  below  1  MB  — >  to  above  1  MB 

10b  -  from  above  1  MB  — >  to  below  1  MB 

lib  =  from  above  1  MB  — >  to  above  1  MB 

—  AX  =  Number  of  words  to  be  moved  (max.  OSOOOh) 

—  Output  :  Carry-Flag  =  1  :  Error 

—  Register  :  AX,  BX,  DL,  CL,  SI,  ES  and  FLAG  are  changed 

—  Info  :  this  function  should  not  be  used  for  moving 

from  RAM  below  the  1  MB  limit 


move 


proc 

near 

push 

ax 

/record  number  of  Words  on  the  Stack 

mov 

ax,es 

/Destination  segment  address  to  AX 

test 

ch,l 

/is  Destination  above  1  MB? 

call 

calc  adr 

/form  24  bit  Address 

mov 

da_hi,dl 

/store  result 

mov 

da_lo,ax 

mov 

ax,  di 

/Source  segment  address  to  AX 

mov 

bx,  si 

/Source  Offset  address  to  BX 

test 

ch,2 

/is  Source  above  1  MB? 

call 

calc  adr 

/form  24  bit  Address 

mov 

sa__hl,dl 

/store  result 

mov 

sa  lo,ax 

mov 

ah,087h 

/Parameter  for  the  Function  call 

push 

ds 

/  load 

pop 

es 

/set  ES  to  DS 

pop 

cx 

/read  number  of  Words  from  Stack 

mov 

si, offset  GDT 

/load  Offset  address  of  GDT 

int 

15h 

/call  RAM  move  function 

ret 

/back  to  caller 

; —  Variables  and  Data  of  the  MOVE-Function - 

GDT  equ  this  word 


sa_lo 
sa  hi 


da_lo 
da  hi 


THIS  IS  THE  GDT  (GLOBAL  DESCRIPTOR  TABLE)  - 

dw  4  dup  (?)  /segment  Descs.  for  Dummy-segment 

; —  this  segment  Descriptor  describes  the  GDT  itself  - 

dw  4  dup  (?) 

; —  segment  Descriptor  of  the  Source-Area  - 

dw  Offffh  /segment  length  =  64  KB 

dw  (?)  /Lo-Word  of  the  24  bit-Address 

db  OlOh  /Hi-Byte  of  the  24  bit-Address 

db  10010010b  /Data  segment  in  storage  with 

/highest  Priority,  Writeable 

dw  OOOOOh  /Compatibility  Word  for  80386 

/ —  segment  Descriptor  of  the  Destination-Area  - 

dw  Offffh  /segment  length  =  64  KB 

dw  (?)  /Lo-Word  of  the  24  bit-Address 

db  (?)  /Hi-Byte  of  the  24  bit-Address 

db  10010010b  /Data  segment  in  storage  with 

/highest  Priority,  Writeable 

dw  OOOOOh  /Compatibility  Word  for  80386 

/ —  this  segment  Descriptor  describes  the  BlOS-Code- segment 
dw  4  dup  (?) 

/ —  this  segment  Descriptor  describes  the  Stack  segment  - 

dw  4  dup  (?) 

/—  END  OF  THE  GDT - 


move  endp 


356 


Abacus 


7.10  The  Cassette  Internet 


—  CALC_ADR  ;  calculates  24  bit  (physical)  Address  - 

—  Input  :  AX:BX  *  Buffer  address  to  be  converted 

—  Zero  Flag  »  1  ;  Buffer  address  above  1  MB 

—  Output  :  DL  *  HI-Byte  of  the  Buffer  address  (bit  16-23) 

:  BX  =«  Lo-Word  of  the  Buffer  address  (bit  0-15) 

—  Register  :  AX,  BX,  DL,  CL  and  FLAGS  are  changed 


calc_adr  proc  near 


mov 

dl,ah 

;H1-Byte  of  the  segment  address  to  DL 

mov 

cl,  4 

;Hi-Nibble  of  the  segment  address 

shr 

dl,cl 

/shifted  to  Lo-Nibble 

jne 

under_lmb 

/test  if  above  1  MB 

or 

dl,010h 

/lies  above  1  MB 

under_lmb:shl 

ax,  cl 

/segment  address  times  16 

add 

ax,bx 

/add  Offset  address 

jnc 

no_more 

/test  for  overflow 

Inc 

dl 

/yes 

no_more:  ret  /back  to  caller 


calc_adr  endp 

initm  db  13, 10, "MO^  (c)  1987  by  Michael  Tischer-, 13, 10, 13, 10 
db  "This  Program  uses  the  Function  87 (h)  of  Interrupt  " 
db  "15(h)  to  copy  memory  blocks", 13, 10, "between  'normal*  " 
db  "RAM  and  RAM  above  the  1-Megabyte  boundary" 13, 10, "$" 

dom  db  "The  Program  copies  first  the  current  display  " 

db  "content  directly", 13, 10, "after  the  1-MB-boundary  and  " 
db  "the  fills  the  screen  with  characters. ",  13, 10 
db  "After  a  key  has  been  activated,  the  old  " 
db  "display  content  ",13,10, "is  restored  and  the  Pro" 
db  "gram  terminated. ",  13, 10, "Please  press  a  key,  to  " 
db  "start  the  Program  ...$" 

sorrym  db  "Since  this  computer  is  not  an  AT,  " 
db  "but  a  PC  or", 13, 10, "XT,  and  these  " 
db  "PCs  can  not  have  storage  beyond  the  1-MB  limit," 
db  13, 10, "this  program  can  not  be  started!  " 
db  "Sorry... ",13,10,"$" 

userm  db  13, 10, "  Please  press  a  " 

db  "key  $" 

errm  db  "WARNING  !  Error  on  access  to  RAM  above  1  MB" 

db  13,10,"$" 

code  ends  ;End  of  the  CODE-segment 

end  movea  ;End  of  the  Assembler- Program. 
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7.11  Accessing  the  Keyboard  from  the  BIOS 

Interrupt  16H  provides  three  functions  to  read  the  keyboard  and  keyboard  status. 
The  BIOS  keyboard  functions  are  very  limited:  No  BIOS  functions  exist  for 
removing  characters  from  the  keyboard  buffer  or  renaming  keys.  DOS  functions 
can  perform  these  operations. 

BIOS-proof  keys 

Some  key  combinations  cannot  be  read  by  BIOS  as  key  codes  because  they  execute 
commands.  Activating  the  <PitSc>  or  <Print>  key  calls  BIOS  interrupt  5H.  This 
starts  a  routine  which  sends  the  current  screen  display  to  a  printer,  producing  a 
hardcopy. 

The  <Ctrl><Num  Lock>  keys  stop  the  complete  system  until  the  user  presses 
another  key.  The  keyboard  buffer  ignores  the  <Ctrl><Num  Lock>  keys  and  the 
subsequently  pressed  key,  so  programs  cannot  read  these  keys. 

Pressing  the  <Ctrl><Break>  key  combination  calls  interrupt  IBH.  Normally  the 
current  program  stops  and  returns  to  DOS.  To  prevent  this,  this  interrupt  can  be 
directed  to  a  routine  within  the  application  program  which  continues  program 
execution  if  the  routine  consists  of  an  IRET  assembly  language  instruction  only. 

ATs  and  a  few  advanced  PC/XTs  have  the  <Sys  Req>  key.  Its  activation  calls 
interrupt  15H  by  passing  the  value  8500H  to  the  AX  register.  When  the  user 
releases  the  key,  the  AX  register  then  receives  the  value  850 IH.  The  value  85H  in 
the  AH  register  represents  the  function  number  of  interrupt  15H.  After  starting  the 
system,  function  85H  of  the  BIOS  interrupt  15H  consists  only  of  an  IRET 
instruction;  pressing  the  <Sys  Req>  key  has  no  visible  result 

Control  codes 

Most  people  know  that  any  ASCII  code  can  be  entered  from  the  keyboard  using  the 
<Alt>  key  and  the  keys  of  the  numeric  keypad.  Few  users  know  about  character 
entry  with  the  help  of  the  <Ctrl>  key.  When  used  in  connection  with  other  keys, 
this  key  can  enter  ASCII  codes  smaller  than  code  number  32.  The  following  figure 
shows  which  keys  can  be  accessed. 
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Function  0:  Read  keyboard 

Interrupt  16H  ncmnally  receives  a  call  when  a  program  expects  usct  input  of  one  or 
more  characters.  If  a  character  was  already  ento'ed  before  the  function  call,  the 
keyboard  buffer  empties  this  characto'  and  passes  it  to  the  calling  program.  If  there 
is  no  character  in  the  keyboard  buffer,  function  0  waits  until  a  charact^  has  been 
input  and  then  returns  to  the  calling  program.  The  caller  can  determine  the 
character  or  activate  a  key  from  the  contents  of  the  AL  land  the  AH  regista^. 


ASCII 


If  the  AL  register  contains  a  value  other  than  0,  it  contains  the  ASCII  code  of  the 
characto'.  The  AH  regist^  ccxitains  the  scan  code  of  the  active  key.  Tbe  code  in  the 
AL  register  corresponds  to  the  ASCII  codes  for  charact^  output  on  the  screen. 
Some  diff^nces  occur  in  the  control  keys: 


Code 

to 

>1 

0) 

8 

<Backspace> 

9 

<Tab> 

10 

<Ctrl><Return> 

13 

<Return> 

27 

<Esc> 

Scan  codes 

The  scan  code  in  the  AH  register  indicates  the  numbo'  of  the  active  key,  where  the 
keys  on  the  keyboard  are  numbered  starting  with  0.  Since  PC,  XT  and  AT 
keyboards  differ,  this  is  unimportant  for  most  programs.  Scan  codes  of  the  various 
keyboards  can  be  found  in  the  A[^ndices  of  this  book. 

Extended  key  codes 

If  the  AL  register  contains  the  value  0  after  the  call,  the  AH  register  indicates  an 
extended  keyboard  code.  The  difference  between  the  ASQI  code  and  the  extended 
keyboard  code  lies  in  the  fact  that  certain  keys  (e.g.,  the  curaor  keys)  cannot  fit 
within  the  PC's  256-character  set  The  following  table  provides  an  overview  of 
extended  keyboard  codes: 


Code (s) 

Key(s) 

15 

<Shift><Tab> 

16-25 

<Alt><Q>, <W>, <E>, <R>, <T>, <Y>, <U>, <I>, <0>, <P> 

iO-38 

<Alt><A>, <S>, <D>, <F>, <G>, <H>, <J>, <K>,  <L> 

44-50 

<Alt><Z>, <X>, <C>, <V>, <B>, <N>, <M> 

59-68 

<F1>-<F10> 

71 

<Home> 

72 

<Cursor  Up> 

73 

<Paqe  Up> 

75 

<Cursor  Left> 

77 

<Cursor  Riqht> 
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Code ( s ) 

Key  (s) 

79 

<End> 

80 

<Cursor  Down> 

81 

<Paqe  Down> 

82 

<Insert> 

83 

<Delete> 

84-93 

<Shift><Fl>-<F10> 

94-103 

<Ctrl><Fl>-<F10> 

104-113 

<Alt><Fl>-<F10> 

115 

<Ctrl><Cursor  Left> 

116 

<Ctrl><Cursor  Right> 

117 

<Ctrl><End> 

118 

<Ctrl><Page  Down> 

119 

<Ctrl><Home> 

120-131 

<Alt><l>,<2>, <3>, <4>, <5>, <6>,<7>, <8>, <9>, <0> 

132 

<Ctrl><Page  Up> 

Key  combinations  not  contained  in  this  table  cannot  be  sensed  using  the  BIOS 
keyboard  functions,  since  they  don’t  generate  keyboard  codes. 

Function  1:  Read  keyboard 

Function  1  also  reads  the  keyboard.  Unlike  function  0,  function  1  leaves  the 
preceding  character  in  the  keyboard  buffer.  Repeated  calls  of  function  1  or  function 
0  read  the  keyboard  again.  Place  the  value  1  in  the  AH  register  to  call  function  1. 
In  contrast  to  function  0,  function  1  immediately  informs  the  calling  program  with 
the  zero  flag  after  the  function  call  if  a  character  is  available  or  not  If  the  zero  flag 
equals  1,  no  character  was  available.  If  the  zero  flag  resets,  the  AL  and  the  AH 
registers  contain  information  about  the  activated  key.  As  in  function  0,  the  AL 
register  contains  the  value  0  if  the  user  activated  an  extended  key,  and  a  value 
unequal  to  0  if  the  user  pressed  a  "normal”  key.  The  AH  register  contains  the  scan 
code  of  normal  keys;  extended  keys  place  their  codes  in  the  AH  register. 

Function  2:  Read  control  keys 

Function  2  has  a  completely  different  task.  It  reads  the  status  of  certain  control 
keys  and  conditions  (e.g.,  <Insert>).  Place  the  numba^  2  in  the  AH  register  to  call 
the  function.  The  keyboard  status  can  be  found  in  the  AL  register  after  the  function 
call. 
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7  6  5  4  3  210 

_ 11  I-  isRIght  SHIFT  key  pressed 

I - isLeft  SHIFT  key  pressed 

-  isCTRL  key  pressed _ 

- la  ALT  key  pressed _ 

-  laSCROLL  LOCK  on 

- laNUM  LOCK  on _ 

-  laCAPS  LOCK  on _ 

- lalNSERT  on 


Keyboard  status  byte 


Demonstration  programs 

The  following  programs  demonstrate  the  various  functions  of  BIOS  keyboard 
interrupts  as  presented  here.  The  four  programs  can  be  divided  into  two  groups. 
The  first  three  programs  are  written  in  the  higher  level  languages  used  throughout 
this  book.  They  call  the  various  functions  of  BIOS  keyboard  interrupts  for  their 
own  uses.  The  fourth  program  is  an  assembler  program.  It  modifies  the  BIOS 
keyboard  interrupt  functions  and  processing,  and  acts  as  a  resident  program  which 
can  be  accessed  at  a  keypress. 

Checking  key  status 

All  three  higher  level  programs  make  a  subroutine  or  a  function  available  for 
reading  characters  from  the  keyboard.  This  alone  is  nothing  special,  since  these 
languages  have  their  own  instructions  that  serve  the  same  purposes.  The  important 
feature  of  the  function  is  that  it  accepts  other  jobs  in  addition  to  the  original  task 
of  reading  characters.  It  displays  the  status  of  the  keyboard  functions  <Insert>, 
<Caps  Lock>  and  <Num  Lock>  in  the  upper  right  hand  comer  of  the  screen.  This 
is  especially  useful  for  XT  and  PC  owners,  since  most  keyboards  don’t  indicate  the 
key  status.  AT  keyboards  and  some  XT  keyboards  provide  light  emitting  diodes 
(LED)  which  indicate  the  status  of  these  keys.  You  never  really  know  if  the 
<Insert>  or  <Caps  Lock>  mode  is  on  or  not. 

Each  program  begins  with  a  routine  which  reads  the  status  of  the  keyboard 
functions  through  function  2  of  BIOS  keyboard  interrupt  16H.  Since  the  program 
only  uses  the  <Ins«t>,  <Caps  Lock>  and  <Num  Lock>  modes,  the  program  only 
views  the  three  highest  level  bits  in  the  keyboard  status  byte.  Based  on  this  status 
byte,  a  flag  initializes  for  every  keyboard  function,  which  indicates  the  status  of 
one  of  these  functions  or  modes  within  the  program.  It  is  reversed  when  compared 
with  the  current  mode.  For  example,  if  the  <Insert>  mode  is  switched  off,  the  flag 
applying  to  it  changes  to  OFF.  An  explanation  of  this  follows  below. 
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Calling  the  interrupt  function 

After  initializing  the  internal  flags,  the  actual  routine  for  keyboard  reading  can  be 
called.  It  also  uses  function  2  of  the  BIOS  keyboard  interrupt  to  read  the  keyboard 
function  status.  It  then  compares  the  current  status  of  each  individual  functicMi  with 
the  previous  status  stored  in  a  flag.  During  its  first  call  after  the  initialization 
routine,  it  determines  if  the  status  of  all  three  functions  has  changed  since  its 
previous  status.  The  change  in  status  causes  the  routine  to  display  the  new  status 
on  the  screen. 

This  explains  the  reason  for  the  flag  reversal  in  the  initialization  routine.  It  allows 
display  of  the  keyboard  function  status  on  the  screen  during  the  first  call  of  the 
keyboard  routine,  and  not  after  it  changed  by  pressing  a  key. 

Now  the  routine  can  proceed  to  its  actual  task  and  read  the  keyboard.  It  uses 
function  1  of  the  BIOS  keyboard  interrupt  to  detect  whether  a  key  is  available  in 
the  keyboard  buffer  of  BIOS.  If  this  is  not  the  case,  the  program  jumps  to  the 
beginning  of  the  routine  and  reads  the  keyboard  function  status  again.  This  creates 
a  loop  which  runs  until  a  keypress  occurs.  This  loop  ensures  that  any  status 
change  is  documented  immediately  on  the  screen. 

Reading  the  keys 

If  a  character  appears  in  the  BIOS  keyboard  buffer  the  loop  terminates  and  BIOS 
keyboard  interrupt  function  2  reads  the  key.  The  last  step  of  this  routine  tests  for 
an  extended  key  code.  If  this  is  the  case,  the  program  adds  256  to  the  code  to  signal 
the  calling  routine  that  an  extended  keyboard  code  was  received.  Then  control 
returns  to  the  calling  routine. 

This  routine  reads  characters  from  the  keyboard  and  displays  them  on  the  screen. 
This  process  repeats  until  the  user  presses  a  certain  key.  If  the  user  presses  the 
<Num  Lock>,  <Caps  Lock>  or  <Insert>  key,  the  screen  immediately  displays  the 
result. 

A  centralized  keyboard  routine  as  presented  here  can  be  used  in  other  programs  for 
additional  tasks.  For  example,  with  the  help  of  this  routine  a  macro  conversion  can 
change  one  key  into  a  string  of  characters.  Another  application  could  display  help 
text  on  the  screen  when  the  user  presses  a  certain  key.  Lotus  1-2-3®  and  dBASE® 
use  this  method  for  displaying  help  screens. 

Note:  A  small  problem  occurs  with  keyboard  flag  output.  Since  displaying 

keyboard  flags  on  the  screen  changes  the  cursor’s  position, 
subsequent  screen  output  from  the  program  occurs  at  different 
locations  than  expected.  These  can  disturb  the  screen  display.  To 
prevent  this,  the  keyboard  routine  must  determine  the  current  cursor 
position  before  the  keyboard  flag  display.  Then  the  routine  must 
restore  the  cursor  position  to  its  old  value  after  displaying  keyboard 
status.  The  problem  of  color  is  very  similar.  Here  the  flag  output 
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assumes  a  certain  color  and  the  old  color  must  be  restored  after  the 
output.  The  problem  is  that  none  of  the  three  languages  has  a 
command  to  determine  the  current  color.  In  Pascal  programs  for 
keyboard  reading,  only  a  special  procedure  can  set  the  color  by 
recording  the  colors  in  a  variable  and  setting  it  with  a  command. 
With  these  variables  the  keyboard  routine  restores  the  current  color 
after  display  of  the  individual  flags. 

BASIC  listing:  KEYB.BAS 


*  K  E  Y  B  *• 


Task 


makes  a  subroutine  available  which  *' 

reads  a  character  from  the  keyboard.  The 
status  of  the  control  keys  *' 

(INSERT,  CAPS,  NUM)  are  displayed  *' 

on  the  screen  *' 

MICHAEL  TISCHER  ** 

7.22.87 

9.21.87  *' 

■  ********************  ************  **-k-k**  ***************  • 


Author 
developed  on 
last  Update 


100 
no 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220  • 

230  CLS  :  KEY  OFF 

240  PRINT-WARNING:  This  Program  can  only  be  started  if  GWBASIC  was  - 

250  PRINT-started  from  the  DOS  level  with  <GWBASIC  /m:60000>.- 

260  PRINT  :  PRINT"If  this  is  not  the  case,  please  input  <s>  for  Stop." 

270  PRINT-Else  press  any  key..."; 

280  A$  *  INKEYS  :  IF  A$  =  "s"  THEN  END 
290  IF  A$  »  THEN  280 

300  GOSUB  60000  'install  function  for  Interrupt  call 

310  CLS  'Clear  Screen 

320  PRINT"TAST  (c)  1987  by  Michael  Tischer"  :  PRINT 

330  PRINT-You  can  input  some  characters  and  change  the  status  of  the  NUM," 

340  PRINT"CAPS  and  INSERT  mode,  where  every  change  is  documented  in  - 

350  PRINT-the  UE^r  right  corner  of  the  display. - 

360  PRINT"The  input  of  <RETURN>  terminates  the  Program..."  :  PRINT 

370  PRINT"Your  Input: 

380  GOSUB  50000  'initialize  keyboard-Flags 

390  GOSUB  51000  'read  a  character 

400  IF  LEN(Z$)  =  2  THEN  390  'on  extended  Code  do  nothing 

410  PRINT  Z$;  'output  characters 

420  IF  ASC(Z$)  <>  13  THEN  390  'on  RETURN  terminate 

430  PRINT 

440  END 

450  ' 

50000 
50010 
50020 
50030 
50040 
50050 
50060 
50070 
50080 
50090 
50100 
50110 
50120 
50130 
50140 
50150 
50160 
50170 
51000 


************************************************************  I 


'*  initialize  keyboard-Flags 


'*  Input:  none  *' 

'*  Output:  none  *' 

'*  Info  :  the  Variable  Z%  is  used  as  a  Dummy  *' 

'*  the  Status  of  the  keyboard  Flags  is  stored  in  *' 

•*  variables  INSERT%,  CAPS%  and  NUM%  *' 

• *****************************★*★★*★★★★*★★★★**★****★*★★★★**** I 

FKT%=2  'get  function  number  for  keyboard  status 

INR%»&H16  'call  BlOS-keyboard-Interrupt  16(h) 

CALL  lA (INR%,  FKT%, FLAGS%, Z%, Z%, Z%, Z%, Z%, Z%,  Z%, Z%, Z%, Z%) 

IF  FLAGS%  AND  128  THEN  INSERT%  -  0  ELSE  INSERT%  =  -1 
IF  FLAGS%  AND  64  THEN  CAPS%  »  0  ELSE  CAPS%  -  -1 
IF  FLAGS%  AND  32  THEN  NUM%  -  0  ELSE  NUM%  »  -1 
RETURN  'back  to  caller 

•  ***★*★***★*★ ************************* ★**★★★★******* ************  I 
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51010 

51020 

51030 

51040 

51050 

51060 

51070 

51080 

51090 

51100 

51110 

51120 

51130 

51140 

51150 

51160 

51170 

51180 

51190 

51200 

51210 

51220 

51230 

51240 

51250 

51260 

51270 

51280 

51290 

51300 

51310 

51320 

51330 

51340 

51350 

51360 

51370 

51380 

51390 

51400 

51410 

52000 

52010 

52020 

52030 

52040 

52050 

52060 

52070 

52080 

52090 

52100 

52110 

52120 

52130 

52140 

5215a 

5216(r' 

52170 

52180 

52190 

52200 

52210 

52220 

52230 

60000 

60010 

60020 

60030 

60040 


*  get  a  character  from  the  keyboard  and  maybe  output  * 

*  Flag-Status  * 

*  _ - _ * 

*  Input:  none  * 

*  Output:  Z$  *  the  character  read  * 

the  Variable  Z%  is  used  as  Dummy  * 

if  2$  Is  two  character  long,  an  extended  * 

keyboard  code  was  input.  The  first  character  of  the* 
string  is  in  such  a  case  the  NUL-character,  * 

and  the  second  character  indicates  the  Code  of  the  * 
extended  key  * 


Info 


********** 


FKT%=2  'get  function  number  for  keyboard  status 

INR%«4H16  'call  BlOS-keyboard-Interrupt  16(h) 

CALL  lA (INR%, FKT%, FLAGS%, Z%, Z%,  Z%, Z%,  Z%, Z%,  Z%, Z%,  Z%, Z%) 

IF  INSERT%  »  ((FLAGS%  AND  128)  »  128)  THEN  51230 


•Insert-Status  has  changed 
•Column  for  Insert -Text 
•Status  of  Insert -Flags 
•  Flag-Text 
•output  Flag-Text 
IF  CAPS%  »  ((FLAGS%  AND  64)  =  64)  THEN  51290 
CAPS%  »  NOT  CAPS%  'Caps-^atus  has  changed 


INSERT%  »  NOT  INSERT% 
C0LMN%  -  75 
FLAG%  =  INSERT% 

FTEXTS  =  "INSERT'^ 
GOSUB  52000 


COIWN%  =  69 
FLAG%  =  CAPS% 
FTEXTS  -  '•  CAPS 
GOSUB  52000 


•Column  for  Caps-Text 
•Status  of  Caps-Flag 
' Flag-Text 
•output  Flag-Text 


IF  NUM%  =  ((FLAGS%  AND  32)  -  32)  THEN  51350 
NUM%  “  NOT  NUM%  'Num-Status  has  changed 

COLMN%  »  66  'Column  for  Num-Text 

FLAG%  =  NUM%  'Status  of  Num-Flag 

FTEXTS  =  "NUM"  'Flag-Text 

GOSUB  52000  'output  Flag-Text 

FKT%*1  'test  function  number  for  characters 

INR%=iH16  'call  BlOS-keyboard-Interrupt  16(h) 

CALL  lA (INR%, FKT%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, FLAGREG%) 

IF  (FLAGREG%  AND  64)  *  64  THEN  51140' no  key  — >  get  Flags 
Z$  =  INKEYS 

RETURN  'back  to  caller 


Set  Cursor  Position  * 

_ _ _ _ _ _ _ —  * 

Input:  FLAG%  =  Status  of  Flags  either  on  or  off  * 

FTEXTS  =  Flag-Text  * 

COIJ4N%  =  is  the  new  column  for  Cursor  * 

CLINE%  =  is  the  new  line  for  Cursor  * 

Output ;  none  * 

Info  :  the  Variable  Z%  is  used  as  a  Dummy  * 

************************************************************* 


CURCLINE%  =  CSRLIN-1  'record  current  Cursor  line 

CURC0LMN%  *  POS(0)-1  'record  current  Cursor  column 

LOCATE  l,COIWN%  'Cursor  position  for  Flag-Text 

IF  FLAG%  THEN  COLOR  0,7  ELSE  COLOR  0,0 
PRINT  FTEXTS 

LOCATE  CURCLINE%+l,CURCOI/iN%+l  'set  old  Cursor  position 
FKT%-2  'set  function  number  for  Cursor  position 

INR%=iH10  'call  BlOS-Video-Interrupt  10(h) 

SEITE%  *  0  'set  Cursor  in  display  page  0 

CALL  IA(INR%, FKT%, Z%, SEITE%,  Z%, Z%,  Z%,CURCLINE%,  CURCOIWN%, Z%, Z%, Z%, Z%) 

COLOR  7,0 

RETURN  'back  to  caller 


***********-< 


'*  initialize  the  Routine  for  Interrupt-call 

<  * _ _ _ _ _ 

' *  Input :  none 

'*  Output:  lA  is  the  Start  address  of  the  Interrupt-Routine 
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60050  * *************************************************************** • 
60060  • 

60070  IA»60000!  ‘Start  address  of  the  Routine  in  the  BASIC-Segment 

60080  DEF  SEG  ‘set  BASIC-Segment 

60090  RESTORE  60130 

60100  FOR  1%  »  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'poke  Routine 
60110  RETURN  ‘back  to  caller 

60120  • 

60130  DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

60140  DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

60150  DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

60160  DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 

60170  DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 

60180  DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

60190  DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

60200  DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

60210  DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

60220  DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

60230  DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 

Pascal  listing:  KEYP.PAS 

I ********************************************************************* } 


{*  K  E  Y  P  •  *} 

(* - *} 

{*  Task  :  makes  a  function  available  for  reading  a  *} 

{*  character  from  the  keyboard  and  outputting  *} 

{*  the  Status  of  the  control  keys  (INSERT, 

{*  CAPS,  NUM)  on  the  display.  *} 

- *} 

{*  Author  :  MICHAEL  TISCHER  *} 


{*  developed  on  :  07/08/87  *} 
{*  last  Update  :  06/10/89  *} 
^ *********************************************************************} 

program  KEYP; 


Uses  Crt,Dos;  {  Add  Crt,  Dos  units  } 

{$V-}  {  Suppresses  string  length  check  } 


FlagText 

=  string [6]; 

{  used  for  passing  the  Flag-Name  } 

FZ 

=  1; 

{  Line  in  which  the  Flags  are  output  } 

FS 

*  65; 

{  Column  from  which  Flags  are  output  } 

FlagFore  *  0; 

{  Foreground  color  of  Flags  } 

FlagBck 

=  7; 

{  Background  color  of  Flags  } 

{**  BIOS  keyboard  status 

bits  *************^^*******************} 

SCRL  * 

16; 

{  ScrollLock  bit  } 

NUML  = 

32; 

{  NumliOck  bit  } 

CAPL  = 

64; 

{  CapsLock  bit  } 

INS  =  128; 

{  Insert  bit) 

{**  Codes  of  some  keys  as  presented  by  GETKEY  *****************} 

BEL 

=  7; 

{  Code  for  bell  character  } 

BS 

=  8; 

{  Code  for  Backspace  character  } 

TAB 

“  9; 

{  Code  for  Tab  character  } 

LF 

=  10; 

{  Code  for  Linefeed  } 

CR 

*  13; 

{  Code  for  Return  ) 

ESC 

»  27; 

{  Code  for  Escape  character  } 

FI 

»  315; 

{  Code  for  FI  key  ) 

F2 

=  316; 

{  Code  for  F2  key  } 

F3 

=  317; 

{  Code  for  F3  key  } 

F4 

=  318; 

(  Code  for  F4  key  ) 

F5 

=  319; 

{  Code  for  F5  key  } 

F6 

»  320; 

{  Code  for  F6  key  } 

F7 

»  321; 

{  Code  for  F7  key  } 
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F8 

»  322; 

{  Code  for  F8  key 

F9 

«  323; 

{  Code  for  F9  key 

FIO 

-  324; 

{  Code  for  FIO  key 

CUP 

“  328; 

{  Code  for  Cursor  up 

CLEFT 

“  331; 

{  Code  for  Cursor  left 

CRIGHT 

»  333; 

{  Code  for  Cursor  right 

CDOWN 

=  328; 

(  Code  for  Cursor  down 

Insert, 

i  Status  of  INSERT  flag 

Num, 

{  Status  of  NUM  flag 

Caps 

:  boolean; 

{  Status  of  CAPS  flag 

ForeColor 

, 

{  current  foreground  color 

BckColor, 

{  current  background  color 

key  : 

integer; 

{  Code  of  key  read 

I  ********* ★*★****★* ***************** ★★***★** **************** **********} 

{*  NEGFLAG;  negate  Flag  and  output  Text  *} 

{*  Input  :  s.u.  *} 

{*  Output  :  the  new  Status  of  the  Flags  (true  =  on,  false  «  off)  *} 

I  ******************************************************************* **j 


function  NegFlag{Flag  :  boolean;  {  the  last  Status  of  the  Flags  } 
FlagReg,  {  current  Status  of  the  Flag  (0  -  off)  } 

Column,  {  Column  for  the  name  of  the  Flags  } 

Cline  :  integer;  {  Line  for  the  Names  of  the  Flags  } 
Text  :  FlagText)  :  boolean;  {  Name  of  the  Flags  } 

var  CurCline,  {  current  Line  } 

CurColumn  :  integer;  {  current  Column  } 


begin 

if  (Flag  and  (FlagReg  =  0) )  or 
(not (Flag)  and  (FlagReg  <>  0) ) 
begin 

CurCline  :=  WhereY; 

CurColumn  :*  WhereX; 
got oxy (Column,  Cline); 
if  FlagReg  =  0  then 
begin 

NegFlag  false; 
text color (0) ; 
textbackground (0) ; 
end 
else 
begin 

NegFlag: “true; 
text color (FlagFore) ; 
textbackground (FlagBck) 
end; 

write (Text) ; 

got oxy (CurColumn,  CurCline); 
text color (ForeColor) ; 
textbackground (BckColor) 
end 
else 

NegFlag  :=  Flag 
end; 


{  test  if  Status  } 
then  {  of  the  Flags  has  changed  } 

{  YES  } 

{  record  current  Line  ) 
i  record  current  Column  } 
{  Cursor  to  Position  for  Flag-Name  } 
{  is  Flag  reset?  } 
{  YES  } 

{  Result  of  the  function  :  Flag  off  } 
{  Foreground  color  is  black  } 
{  Background  color  is  black  } 


{  Flag  is  now  on  } 
{  Result  of  the  function  :  flag  on  } 
{  Foreground  color  is  FLAGFORE) 
{  Background  color  is  FLAGBCK  } 

{  Output  name  of  the  flag  ) 
(  restore  old  cursor  position  } 
{  restore  old  foreground  color  ) 
{  restore  old  background  color  } 


{  Status  of  flags  has  not  changed  } 


{********************************************************************* ^ 


{*  GETKEY:  Read  a  character  and  output  the  flag  status  *} 
{*  Input  :  none  *) 
{*  Output  :  Code  of  the  key  <  256  :  normal  key  *} 
{*  >-  256  :  extended  key  *} 


I  ********************************************************************* j 

function  Getkey  :  integer; 

var  Regs  :  Registers;  {  Register  variable  for  interrupt  call  } 

keyRec  :  boolean;  {  indicates  if  key  already  received  } 
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begin 

keyRec  :*  false;  {  no  key  received  } 

repeat 

Regs. ah  $2;  {  read  function  number  for  keyboard  status  } 

intr($16,  Regs);  {  call  BIOS  keyboard  interrupt  } 


{ **  Adjust  flags  to  new  status  *************************************} 
Insert  :«  NegFlag (Insert,  Regs.al  and  INS,  FS+9,  FZ,  'INSERT'); 

Caps  :*  NegFlag(Caps,  Regs.al  and  CAPL,  FS+3,  FZ,  *  CAPS  '); 

Num  NegFlag(Num,  Regs.al  and  NUML,  FS,  FZ,  'NUM'); 

Regs. ah  :»  $1;  {  function  number  for  character  ready?  } 

intr($16,  Regs);  {  call  BIOS  keyboard  interrupt  } 

if  (Regs. flags  and  FZero  »  0)  then 
begin 

KeyRec  :=  true; 

Regs. ah  :»  0; 
intr($16,  Regs); 

if  (Regs.al  *  0)  {is  zero  flag  set  ?  } 

then  Get key  :=  Regs. ah  or  $100  {  YES  } 

else  Getkey  :=  Regs.al;  {  NO  ) 

end; 

until  keyRec;  {  repeat  until  a  key  is  received  } 

end; 


{*  INIKEY:  initialize  keyboard  flags  *} 
{*  Input  :  none  *) 
{*  Output  :  none  *} 
{*  Info  :  the  keyboard  flags  are  inverted  from  the  current  *} 
{*  status.  This  outputs  their  current  *} 
{*  status  during  the  next  call  of  the  GETKEY  function.  *) 


procedure  Inikey; 


var  Regs  :  Registers; 
begin 

Regs. ah  :»  $2; 
intr($16,  Regs); 
if 


{  Register  variable  for  interrupt  call  } 


{ 


Read  function  numlDer  for  keyboard  status 
{  call  BIOS  keyboard  interrupt 


(Regs.al  and  INS  <>  0)  then  Insert  :=  false  {  INSERT  flag 

else  Insert  :=  true;  {  set 

if  (Regs.al  and  CAPL  <>  0)  then  Caps  :=  false  1  CAPS  flag 

else  Caps  :«  true;  {  set 

if  (Regs.al  and  NUML  <>  0)  then  Num  :=  false  {  NUM  flag 

else  Num  :=  true  {  set 

end; 


{*  SCOLOR:  sets  foreground  and  background  colors  for  display  *} 

{*  Input  :  see  below 

{*  Output  :  none  ♦) 

{*  Var.  :  the  color  is  stored  in  the  global  variables  FORECOLOR  *} 

and  BCKCOLOR  *} 

{’*  Info  :  this  procedure  must  be  called  for  setting  the  color  *} 

{*  so  that  after  the  output  of  the  keyboard  flag  status, 

{"  the  current  text  color  can  be  restored  *) 

{*  since  in  TURBO  no  functions  exist  for  sensing  *} 

{*  this  color 


procedure  Scolor (Foreground,  Background  :  integer) ; 


begin 

ForeColor  Foreground; 
BckColor  :*  Background; 
textcolor (Foreground) ; 
textbackground (Background) 
end; 


{  Record  foreground  color  } 

(  Record  background  color  } 

{  Set  foreground  color  } 

{  Set  background  color  1 
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^  *************** ★★★★*****<^***<r***********<r*** **★*****★★★* ★**★★******★*} 

{*  MAIN  PROGRAM  *} 

I*********************************************************************} 


begin 

Inikey;  {  Initialize  keyboard  flags  ) 

Scolor(7,0);  {  Color  is  white  on  black  } 

clrscr;  {  Clear  screen  } 

writeln(#13#10'KEYP  (c)  1987  by  Michael  Tischer'); 
writeln(#13#10 'A  few  characters  can  be  input  now  and  switch  '+ 
•INSERT-,  CAPS-  or  NUM-'); 

writeln( 'mode  on  or  off.  The  status  of  the  three  '+ 

•modes  is  always  displayed  in'); 
writelnCthe  upper  right  corner  of  the  screen.*); 
writelnC Pressing  the  <RETURN>  or  the  <Fl>-key  terminates  the  •+ 
•program. . . ') ; 

write (#13#10' Your  Input;  '); 
repeat 

key  :»  Getkey; 

if  (key  <  256)  then  write (chr (key) ) 
until  (key  *  13)  or  (key  »  FI); 
writeln; 
end. 


{  Input  loop  } 
{  Get  key  } 
{  Output  (if  normal)  } 
{  Repeat  until  FI  or  CR  } 


C  listing:  KEYC.C 

/*********************************************************************/ 


/*  K  E  Y  C  */ 

/* - - */ 

/*  Task  :  provides  a  function  for  reading  a  */ 
/*  character  from  the  keyboard  and  to  output  */ 
/*  the  Status  of  the  control  keys  (INSERT,  */ 
/*  CAPS,  NUM)  on  the  display.  */ 

/*  Author  ;  MICHAEL  TISCHER  */ 
/*  developed  on  :  8/13/87  */ 
/*  last  update  :  6/09/89  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 
/*  Creation  ;  MSC  TASTC;  */ 
/*  LINK  TASTC;  */ 
/*  Call  :  TASTC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 
/*  Creation  ;  Make  sure  that  Case-sensitive  link  is  OFF  in  */ 
/*  the  Options  menu/Linker  option  */ 
/*  Select  RUN  menu  */ 


/*********************************************************************/ 


♦include  <dos.h>  /*  include  Header-Files  */ 

♦include  <io.h> 

♦include  <bios.h> 

/*==  Type  definitions 

typedef  unsigned  char  byte;  /*  Create  a  byte  */ 

/ *==  Constants  ======================================================*/ 


/* —  Bit  layout  in  BIOS  keyboard  status 


.*/ 


♦define  SCRL  16 
♦define  NUML  32 
♦define  CAPL  64 
♦define  INS  128 


/*  ScrollLock  bit  */ 
/*  NumLock  bit  */ 
/*  CapsLock  bit  */ 
/*  Insert  bit  */ 


♦define  FALSE  0 
♦define  TRUE  1 


/*  Constants  make  reading  of  the  */ 
/*  Program  text  easier  */ 
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♦define  FZ  0  /*  Line  in  which  the  Flags  should  be  output  */ 
♦define  FS  65  /*  Column,  in  which  Flags  will  be  output  */ 
♦define  FlagColour  0x70  /*  black  characters  on  white  ground  */ 


/*—  Coc 

les  of 

some  keys  as 

returned  by  GETKEYO  - 

— 

-*/ 

♦define 

BEL 

7 

/*  Bell  character 

code 

*/ 

♦define 

BS 

8 

/*  Backspace  key 

code 

*/ 

♦define 

TAB 

9 

/*  Tab  key 

code 

*/ 

♦define 

LF 

10 

/*  Linefeed 

code 

*/ 

♦define 

CR 

13 

/*  Return  key 

code 

*/ 

♦define 

ESC 

27 

/*  Escape  key 

code 

*/ 

♦define 

FI 

315 

/*  FI  key 

code 

*/ 

♦define 

F2 

316 

/*  F2  key 

code 

*/ 

♦define 

F3 

317 

/*  F3  key 

code 

*/ 

♦define 

F4 

318 

/*  F4  key 

code 

V 

♦define 

F5 

319 

/*  F5  key 

code 

*/ 

♦define 

F6 

320 

/*  F6  key 

code 

*/ 

♦define 

F7 

321 

/*  F7  key 

code 

*/ 

♦define 

F8 

322 

/*  F8  key 

code 

*/ 

♦define 

F9 

323 

/*  F9  key 

code 

V 

♦define 

FIO 

324 

/*  FIO  key 

code 

*/ 

♦define 

CUP 

328 

/*  Cursor  up 

code 

*/ 

♦define 

CLEFT 

331 

/*  Cursor  left 

code 

*/ 

♦define 

CRIGHT 

333 

/*  Cursor  right 

code 

*/ 

♦define 

CDOWN 

328 

/*  Cursor 

down 

V 

/* —  global  Variables  - 

_ 

-*/ 

byte  Insert, 
Num, 
Caps; 


/*  Status  of  INSERT  flag  */ 
/*  Status  of  NUM  flag  */ 
/*  Status  of  CAPS  flag  */ 


/★★★A************************************ 

/*  GETPAGE:  get  the  current  display  page 
/*  Input  :  none 
/*  Output  :  see  below 
/*****************«*«**********<,****,**** 


V 

*/ 

*/ 


byte  GETPAGE 0 
{ 

union  REGS  Register;  /*  Register  variable  for  interrupt  call  */ 

Register. h. ah  =15;  /*  function  number  */ 

int86{0xl0,  &Register,  iRegister) ;  /*  call  interrupt  10(h)  */ 

return (Register. h. bh) ;  /*  Number  of  current  display  page  */ 

} 


/*  SETPOS:  sets  the  position  of  cursor  in  current  display  page  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 
/*  Info  :  the  position  of  the  blinking  cursor  changes  */ 
/*  with  the  call  of  this  function  only  if  */ 
/*  display  page  indicated  is  the  current  display  page  */ 


void  SetPos(byte  Column,  byte  Line) 

( 

union  REGS  Register;  /*  Register-Variable  for  Interrupt  call  */ 


Register. h. ah  =  2; 

Register.h.bh  =  GETPAGE (); 
Register. h.dh  =  Line; 

Register. h.dl  =  Column; 
int86(0xl0,  iRegister,  iRegister); 

) 


/*  function  number  */ 
/*  Display  Page  */ 
/*  Display  Line  */ 
/*  Display  Column  */ 
/*  call  Interrupt  10(h)  */ 
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/*  GETPOS:  Gets  the  Position  of  Cursor  in  the  current  Display  Page  */ 
/*  Input  :  none  */ 
/*  Output  :  see  below  */ 
/**★**★★**★****★**★****★***********************★★★********************/ 


void  GetPos(byte  *  CurColumn,  byte  *  CurLine) 


{ 

union  REGS  Register;  /*  Register  variable  for  interrupt  call  */ 


Register.h.ah  «  3; 

Register.h.bh  «  GETPAGEO; 

int86(0xl0,  &Reglster,  &Register) ; 
♦CurColumn  =  Register. h.dl; 

♦CurLine  =  Register. h.dh; 

} 


/*  function  number  */ 
/*  Display  page  */ 
/*  call  Interrupt  10  (h>  */ 
/*  Result  of  the  function  ♦/ 
/*  Read  from  the  register  */ 


/*  WRITECHAR;  writes  a  character  with  an  Attribute  to  */ 
/*  the  current  cursor  position  in  current  display  page  */ 
/♦  Input  :  see  below  */ 
/♦  Output  :  none  */ 


^•k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kii-k-k-k-k-k-k-k-k^ifk-k-k-kli.'ktfkn-k-k-k-k-k-tfk-k-k-k-k-k-k-k-k-k-k-k-^-k-k-k-k-k-k-k-k-k-k-k-k-k-kf 


void  WriteChar (char  Zcharacter,  byte  Colour) 


{ 

union  REGS  Register;  /♦  Register  variable  for  interrupt  call  */ 


Register.h.ah  =  9; 

Register.h.bh  »  GETPAGEO; 
Register. h.al  »  Zcharacter; 
Register. h.bl  *=  Colour;  / 

Register.x.cx  »  1; 
int86(0xl0,  ^Register,  iRegister) ; 

} 


/*  function  number  */ 
/*  Display  Page  */ 
/*  the  character  for  output  */ 
Color  of  character  to  be  output  */ 
/♦  output  character  only  once  */ 
/*  call  Interrupt  10(h)  */ 


/*  WRITETEXT:  write  a  character  chain  with  constant  color  */ 
/*  starting  at  a  certain  location  in  the  current  */ 
/*  Display  Page  */ 
/*  Input  :  see  below  */ 
/*  Output  :  none  */ 
/*  Info  :  Text  is  a  Pointer  to  a  character-Vector  which  */ 
/♦  contains  the  Text  to  be  output  and  is  terminated  with  ♦/ 
/♦  a  '\0'  character.  */ 


y**********************!***********************************************/ 


void  WriteText (byte  Column,  byte  Line,  char  ‘Text,  byte  Colour) 


{ 

union  REGS  InRegister, 

Out Register;  /‘  Register  variable  for  interrupt  call  */ 


SetPos (Column,  Line); 
InRegister .h. ah  =  14; 
InRegister. h.bh  =  Get  Page (  ); 
while  (‘Text) 

{ 


/*  set  Cursor 
/‘  function  number 
/*  Display  Page 
/‘  output  Text  until  '\0'  character 


WriteChar ('  Colour);  /*  Indicate  color  for  character 

InRegister. h.al  *  ‘Text++;  /*  the  character  for  output 

int86(0xl0,  ^InRegister,  &OutRegister) ;  /*  call  Interrupt 

} 


} 


‘/ 

*/ 

‘/ 

*/ 

*/ 

*/ 

*/ 


/*  CLS:  erase  current  Display  Page  */ 
/*  Input  :  none  */ 
/*  Output  :  none  */ 
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void  Cls() 


{ 

union  REGS  Register;  /*  Register  variable  for  interrupt  call  */ 


Register.h.ah  -  6; 
Register. h.al  »  0; 
Register. h.bh  -  7; 
Register. x.cx  »  0; 
Register. h.dh  *  24; 
Register. h.dl  -  79; 
Int86(0xl0,  ^Register, 

} 


/*  function  number  for  scroll  up  */ 
/*  0  stand  for  clear  */ 
/*  white  letters  on  black  background  */ 
/*  upper  left  display  corner  */ 
/*  Coordinates  of  the  lower  */ 
/*  right  display  comer  */ 
^Register);  /*  call  BlOS-Video-Interrupt  */ 


/*********************************************************************/ 
/*  NEGFLAG;  negate  Flag  and  output  Text  */ 

/*  Input  ;  see  below  */ 

/*  Output  :  the  new  Status  of  Flags  (TRUE  =  on,  FALSE  *  off)  */ 


byte  NegFlag(byte  Flag,  unsigned  Int  FlagReg, 

byte  Column,  byte  Line,  char  *  Text) 


{ 


byte  CurLine, 

/*  current  Line 

*/ 

CurCol umn. 

/*  current  Column 

V 

Colour; 

/*  for  Output  of  Flag-Text 

*/ 

if  (‘(Flag  ==  (FlagReg  !»  0))} 

/*  did  Flag  change? 

*/ 

{ 

/*  YES 

*/ 

GetPos (&CurColumn,  sCurLine); 

/*  get  current  Cursor  position 

*/ 

WrlteText  (Column,  Line,  Text, 

(Flag)  ?  0  :  FlagColour) ; 

SetPos (CurCol umn,  CurLine) ; 

/*  set  old  Cursor  position 

*/ 

return  (Flag  ''1); 

/*  reverse  Bit  1  of  Flags 

*/ 

s 

else  return (Flag) ; 

/*  everything  remains  the  same 

*/ 

} 

/******************************************************************★**/ 
/*  KEYREIADY:  Tests  for  a  character  from  the  keyboard  */ 

/*  Input:  none  */ 

/*  Output:  TRUE  if  a  key  is  pressed,  otherwise  FALSE  */ 

/»k********************************************************************/ 

int  KeyReadyO 

{ 

#lfdef  _TURBOC_ 

Struct  REGPACK  Register; 

Register. r_ax  =  1  «  8; 

intr(0xl6,  &Register); 

ret urn (!  (Register .r_f lags  &  64)  }; 

lelse 


ret  urn (  bios  keybrd (  KEYBRD  READY  )  ) ; 

#endif 

) 


/** 


/*  GETKEY:  Read  a  character  and  Output  Flag- Status  */ 
/*  Input  :  none  */ 
/*  Output  :  Code  of  key  read  <256  :  normal  key  */ 
/*  >-  256  :  extended  ke  y  */ 
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unsigned  Int  GetKeyO 

union  REGS  Register;  /*  Register  Variable  for  Interrupt  call  */ 

do 

{ 

Register. h. ah  »  2;  /*  read  function  number  for  keyboard  status  */ 

int86(0xl6,  &Register,  ^Register);  /*  call  BIOS  keyboard  interrupt*/ 
Insert  =  NegFlag (Insert,  Register. h.al  &  INS,  FS+9,  FZ,  “INSERT"); 

Caps  *  NegFlag (Caps,  Register. h.al  &  CAPL,  FS+3,  FZ,  “  CAPS  “); 

Num  =  NegFlag (Num,  Register. h.al  &  NUML,  FS,  FZ,  “NUM"); 

} 

while  (  IKeyReadyO  ); 

Register.h.ah  »  0;  /*  read  function  number  for  key  */ 

int86(0xl6,  (Register,  (Register);  /*call  BlOS-keyboard- Interrupt*/ 
return ( (Register. h.al)  ?  Register. h.al  :  Register.h.ah  |  256); 

} 

/*★*★**★******★*****************************★★**★★★*★★*★★*★★★*★★*★*★★★/ 


/*  INIKEY:  initialize  keyboard-Flags  */ 
/*  Input  :  none  */ 
/*  Output  :  none  */ 
/*  Info  ;  the  keyboard-Flags  are  reversed  compared  with  the  */ 
/*  current  status.  This  makes  it  possible  that  their  */ 
/*  current  Status  is  output  on  the  next  call  of  the  */ 
/*  GETKEY- function.  */ 


void  InikeyO 
{ 

union  ElEGS  Register;  /*  Register  variable  for  interrupt  call  */ 

Register.h.ah  =  2;  /*  read  function  number  for  keyboard  status  */ 

int86(0xl6,  (Register,  (Register);  /*  call  BlOS-keyboard-Interrupt*/ 
Insert  »  (Register .h.al  (  INS)  ?  FALSE  :  TRUE  ;  /*  reverse  the  */ 

Caps  =  (Register. h.al  (  CAPL)  ?  FALSE  :  TRUE  ;  /*  current  content  */ 
Num  =  (Register. h.al  (  NUML)  ?  FALSE  ;  TRUE  ; 

} 

/*******************«*************************************★*********★*/ 
/**  MAIN  PROGRAM  **/ 

/******★★*★★****************  ***********★***★******★***★★**★*****★*****/ 


void  mainO 


unsigned  int  key; 


Cls();  /*  Clear  Screen  */ 

SetPos(0,0);  /*  Cursor  to  left  upper  screen  corner  */ 

printfC'KEY  (c)  1987  by  Michael  Tischer\n\n") ; 

printfC'You  can  input  some  characters  and  at  the  same  time  change  “); 
printf (“INSERT-,  CAPS-\nor  NUM-status.  Every  change  “); 
printf(“is  displayed  in  the  upper  right  corner  of  the  screen. \n“); 
printf ("\n<RETURN>  or  <F1>  terminates  the  Input. . .\n\n“) ; 
pr i nt  f ( “Your  I nput :  " ) ; 

InikeyO;  /*  initialize  keyboard-Flags  */ 

do 
{ 

if  ((key  =  GetkeyO)  <  256)  /*  read  key  */ 

printf (“%c“,  (char)  key);  /*  output  (if  normal)  */ 

} 


while  (! (key  *=  CR  | |  key  -=  FI));  /*  repeat  until  FI  or  CR  */ 

printf  ("\n'')  ; 


} 
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A  resident  interrupt  driver 

The  next  assembler  program  is  a  resident  interrupt  driver.  Once  a  resident  program 
is  installed  in  memory,  other  programs  or  data  cannot  overwrite  it  Another  reason 
for  the  name  resident  lies  in  the  program's  ability  to  point  to  an  interrupt  in  its 
own  routine.  Instead  of  DOS,  BIOS  or  another  interrupt  routine  called  up  to  now, 
the  program  calls  its  own  interrupt  driver  routine.  Before  examining  how  this  is 
done,  the  assembler  program  should  be  explained. 

The  SHOWCLK  program  displays  the  current  time  on  the  screen  every  time  the 
user  presses  a  certain  key  after  installing  it.  This  occurs  until  another  key  is 
depressed.  The  key  which  causes  the  time  to  be  displayed  must  be  passed  to  the 
program  in  the  command  line  during  its  call.  For  example,  entering  the  following 
at  the  DOS  prompt  invokes  the  program  and  tells  the  program  to  display  the  time 
when  the  user  presses  the  <F10>  key  on  the  XT,  or  the  <F8>  key  on  the  AT 
keyboard.  When  the  key  is  pressed,  the  time  appears  on  the  screen  at  line  1  starting 
at  column  40: 

showclk  68  /II  /c40 

The  following  removes  the  SHOWCLK  program  from  memory  (note  the  lack  of 
parameters): 

showclk 

The  only  stipulation  is  that  the  actuating  key  must  be  one  that  generates  an 
extended  key  code  (e.g.,  a  cursor  key  or  function  key).  The  program  sets  the  default 
clock  position  to  the  upper  right  comer  of  the  screen.  This  can  be  changed  by 
passing  parameters  in  the  command  line  during  the  program  call.  Another  facet  of 
the  program  is  its  ability  to  re-install  itself  during  a  new  call,  if  the  user  desires. 


********************************************************************* 


.  ★ 

SHOWCLK 

★  • 
f 

;* 

Task 

9 

;  Outputs  the  time  on  the  display  after  pressing*; 

•  * 

a  key  which  generates  an  extended  key  code 

★ . 
r 

•  ★ 
f 

stops  when  another  key  is  pressed 

*; 

•  * 

$ 

Author 

:  MICHAEL  TISCHER 

* 

r 

•  ★ 
f 

developed  on 

:  8/1/87 

*  . 

•  -k 

9 

•  ★ _ 

last  Update 

:  9/21/87 

*  • 
f 

9 

•  ★ 

9 

assembly 

:  MASM  SHOWCLK 

★  • 

m  if 

9 

LINK  SHOWCLK 

k  m 

•  ★ 

EXE2BIN  SHOWCLK  SHOWCLK.COM 

k  • 
9 

tmk  • 

9 

•  ★ 

Call 

:  SHOWCLK  [Key-code]  [/ILine]  [/cColumn] 

k  • 
9 

********************************************************************* 


TAB  equ  9 

LF  equ  10 

CR  equ  13 

here  starts  the  actual  Program 
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code 

start: 

segment  para  'CODE'  /Definition  of  the  CODE-Seginent 

org  lOOh 

assume  cs:code,  ds:code,  es:code,  ss:code 

jirp  showinit  /Call  of  the  Initialization-Routine 

alterint 

equ 

this  dword 

/old  interrupt  vector  16(h) 

intaltofs  dw  (?) 

/Offset  address  interrupt  vector  16(h) 

Intaltseg  dw  (?) 

/Segment  address  interrupt  vector  16(h) 

extlcey 

db  (1) 

/extended  keyboard-code,  on  which 

Iceycode 

db  (? 

) 

/the  program  is  called 

llnepos 

equ  this  word 

column 

db  75 

;Line  and  column  in  which  the  time 

line 

db  0 

# 

is  output 

buffer 

dw  5 

dup  (?)  ; 

;  stores  the  characters  frcxii  the  clock 

;==  this 

is  the  new  kyboard-interrupt  (remains  in  memory) 

newint 

proc 

far 

jmp 

short  newi_l 

db  “MT" 

/Identification  of  the  program 

newi  1: 

or 

ah,  ah 

/read  character  (Function  0)? 

je 

newi  2 

/YES  — >  get  character  and  test 

jmp 

aint 

/NO  — >  call  old  interrupt 

newi  2: 

pushf 

/for  smulation  of  an  interrupt  call 

call 

cs: [alterint] 

/call  old  interrupt 

cmp 

ax,cs:word  ptr  extkey  /was  it  the  specified  key? 

je 

showtime 

/YES  — >  display  clock 

jmp 

aiend 

/NO  — >  back 

the  specified  key 

was  activated  - 

showtime: 

pushf 

/all  registers  which  are  changed 

push 

ax 

;  must  be  stored 

push 

bx 

push 

cx 

push 

dx 

push 

di 

push 

si 

push 

es 

push 

ds 

cld 

/on  sring  commands  count  up 

mov 

ah,  15 

/read  current  display  page 

int 

lOh 

/call  BIOS  video-interrupt 

mov 

ah,  3 

/read  current  cursor  position 

int 

lOh 

/call  BIOS  video-interrupt 

push 

dx 

/store  on  the  stack 

push 

cs 

/ Code-sgment  to  the  stack 

pop 

ds 

/return  as  DS 

mov 

dx, linepos 

/set  cursor  position 

mov 

ah,  2 

/for  the  time 

int 

lOh 

/call  BIOS  video-interrupt 

push 

cs 

/Code-segment  to  the  stack 

pop 

es 

/return  as  ES 

mov 

cx,  5 

/read  5  characters 

mov 

di, off set  buffer 

/Address  of  the  character-buffer 

getz: 

mov 

ah,  8 

/read  1  character 

int 

lOh 

/call  BIOS  video-interrupt 
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stosw 

/store  character  in  the  buffer 

inc 

dl 

/next  display  column 

mov 

ah,  2 

/set  cursor  position 

int 

lOh 

/call  BIOS  video-interrupt 

loop  getz 

/get  next  character 

mov 

dx,  linepos 

/set  cursor  position 

mov 

ah,  2 

/for  the  time 

int 

lOh 

/call  BIOS  video- interrupt 

mov 

ah,2CH 

/get  time  frcxn  DOS 

int 

21h 

/call  DOS-interrupt 

mov 

bl,70h 

/color  of  clock:  inverted 

push 

cx 

/record  minutes 

mov 

al,ch 

/change  hours  to  ASCII 

call 

bia 

/and  output 

mov 

al,-:- 

/output  colon 

call 

prz 

pop 

ax 

/get  minutes 

/function  number 

for  character  output 

xchg  bl,ah 

/exchange  AH  and  BL 

int 

lOh 

/call  BIOS  video-interrupt 

inc 

dl 

/next  column 

mov 

ah,  2 

/set  cursor  position 

int 

lOh 

/call  BIOS  video-interrupt 

dec 

di 

/output  another  character  ? 

jne 

storz 

/YES  ~>  STORZ 

pop 

dx 

/get  old  cursor  position 

mov 

ah,  2 

/and  set  again 

int 

lOh 

/call  BIOS  video-interrupt 

pop 

ds 

/restore  all  stored  registers 

pop 

es 

pop 

si 

pop 

dl 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

popf 

xor 

ah,  ah 

/jmp 

newi_2 

aint: 

pushf 

/simulate  interrupt -routine 

call 

cs: [alterint] 

/call  next  keyboard-routine 

aiend: 

ret 

2 

/ f lag-regi ster 

newint 

endp 

/—  BIA: 

change  binary  to  ASCII 

and  output  - 

/ —  Input  :  AL  *  the  number  to 

be  converted 

; —  Output  :  none 

; —  Register  :  CX,  AX,  DL  and  FLAGS  are  changed 

bia  proc  near 

mov  cl,  10 
xor  ah, ah 
div  cl 
or  ax, 3030h 
push  ax 
call  prz 
pop  ax 
mov  al,ah 
call  prz 
ret 

bia  endp 

; —  PRZ:  output  character  and  increment  cursor  position 
; —  Input  :  BH  »  Display  page  for  Output 
; —  AL  =  the  character  for  output 


;we  work  in  the  decimal  system 
; prepare  16  bit  division 
; divide  AX  by  CL 
; change  result  to  ASCII 
/store  nuntoer 

/output  character  and  advance  cursor 

/read  number 

/move  character  to  AL 

/output  character  and  advance  cursor 

/back  to  caller 
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; —  BL  -  Attribute  (color)  of  the  character 

; —  Output  :  none 

; —  Register  :  CX,  AH,  DL  and  FLAGS  are  changed 


prz  proc  near 


mov 

ah,  9 

/function  number  for  character 

mov 

cx,  1 

/output  character  only  once 

int 

lOh 

/call  BIOS  video-interrupt 

mov 

ah,  3 

/read  current  cursor  position 

int 

lOh 

/call  BIOS  video-interrupt 

inc 

dl 

/increment  cursor  column 

mov 

ah,  2 

/set 

int 

lOh 

/call  BIOS  video-interrupt 

ret 

/bac)c  to  caller 

output 


prz  endp 

instend  equ  this  byte  ;if  SHOWCLK  installed,  memory  can  be 

/released  starting  at  this  location 


;==  Data  (can  be  overwritten  by  DOS)  =« 


badp 

db 

installm 

db 

db 

db 

db 

deactivm 

db 

allinm 

db 

noinstm 

db 

partab 

dw 

“Invalid  Parameter", CR,IiF,*'$" 

"SHOWCLK  (c)  1987  by  Michael  Tischer",  13, 10, 13, 10 
"SHOWCLK  was  installed  and  can  be  deactivated  ",13,10 
"with  a  new  call  ",13,10 
" (but  without  Parameters) ", CR, LF, "$" 

"SHOWCLK  was  deactivated", CR, LF, "$" 

"SHCWCLK  is  already  installed", CR, LF, "$" 

"no  SHOWCLK  installed", CR, LF, "$" 

63  dup  (?)  /Address  of  command  line  parameter 


/==  program  (can  be  overwritten  by  DOS)  ==========*====*=» 


deactivate  label  near 


/turn  SHOWCLK  off 


entfe: 


noinst : 


/ —  Start 
showinit 


mov 

ax,3516h 

/get  content  of  interrupt  vector  16 

int 

21h 

/call  DOS-Function 

anp 

word  ptr  es:[bx+2]. 

"TM"  /test  if  SHCWCLK-program 

jne 

noinst 

/SHOWCLK  not  installed  — >  End 

mov 

dx,es: intaltofs 

/Offset  address  of  interrupt  16(h) 

mov 

ax,es:intaltseg 

/Segment  address  of  interrupt  16(h) 

mov 

ds,ax 

/to  DS 

mov 

ax,2516h 

/reset  content  of 

int 

21h 

/interrupt  vector  16(h)  old  routine 

mov 

ah,49h 

/release  storage 

int 

21h 

/of  old  SHCWCL  again 

push  cs 

/store  CS  on  the  Stac)c 

pop 

ds 

/restore  DS 

mov 

dx, offset  deactivm 

/Message:  program  removed 

xor 

al,al 

/program  performed  correctly 

jmp 

showend 

/to  end  of  program 

mov 

dx, offset  noinstm 

/Error-Message:  no  SHOWCLK  installed 

jmp 

short  noinerr 

/output  Error-Message  and  terminate 

and  Initialization-Routine 


proc  near 

cld  /on  String  commands  count  up 

mov  di, offset  partab  /Address  of  Parameter-Table 
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call  parmtest 
or  dl,dl 
je  deactivate 

; count  Parameter /determine  Address 
;if  no  Parameter  indicated 
;YES  — >  remove  last  SHOWCL 

mov 

bx, offset  partab 

; Address  of  the  Parameter-Table 

paraout : 

mov 

si,  [bx] 

;get  Address  of  a  Parameter 

lodsw 

;get  first  two  chars  of  parameter 

and 

ah, 11011111b 

; lower  case  letters  — >  upper  case 

anp 

ax,"L/'* 

;is  it  line  indication  ? 

je 

get line 

;YES  ~>  GETLINE 

onp 

ax, -C/“ 

;is  it  column  indication? 

je 

get column 

;YES  — >  GETCOLUMN 

; —  Paranveter  must  be 

Key  code  - 

crop 

extkey, 0 

;Key  code  discovered? 

je 

badpara 

;YES  — >  Error 

push 

bx 

;save  Pointer  in  PARTAB 

push 

dx 

;save  remaining  number  of  Parameters 

sub 

si, 2 

;set  SI  to  beginning  of  number 

call 

asclibin 

; convert  Code  to  binary 

pop 

dx 

;get  remaining  number  of  Parameters 

pop 

bx 

;get  Pointer  in  PARTAB 

jc 

badpara 

;no  number  found  — >  Error 

or 

ah,  ah 

; number  larger  than  255? 

jne 

badpara 

;YES  — >  wrong  number 

mov 

key code, al 

; number  o.k.  record  it 

mov 

extkey, 0 

/announce  Key  code  discovery 

nextpara : 

add 

bx,2 

/Address  of  the  next  PARTAB-Element 

dec 

dl 

/decrease  Parameter  counter 

jne 

paraout 

/last  Parameter?  NO  — >  continue 

jmp 

short  install 

/Parameter  o.k.  — >  install  program 

get line: 

mov 

di, offset  line 

/Address  of  Line-Variable 

mov 

dh,24 

/Maximum  value  for  Line 

jmp 

pareval 

/evaluate  Parameter 

getcolumn:mov 

di, offset  column 

/Address  of  the  Column-Variable 

mov 

dh,75 

/Maximum  value  for  column 

pareval : 

push 

bx 

/store  Pointer  in  PARTAB 

push 

dx 

/store  remaining  number  of  Parameters 

call 

asciibin 

/convert  Code  to  binary 

pop 

dx 

/get  remaining  number  of  Parameters 

pop 

bx 

/get  Pointer  in  PARTAB 

jc 

badpara 

/no  number  found  — >  Error 

or 

ah,  ah 

/Number  larger  than  255? 

jne 

badpara 

/YES  — >  wrong  number 

dtp 

al,dh 

/Number  larger  than  permitted? 

je 

badpara 

/YES  — >  wrong  number 

mov 

[dil,al 

/Number  o.k.  therefore  store 

jmp 

short  nextpara 

/evaluate  next  prameter 

allinst: 

mov 

dx, offset  allinm 

/Error-Message:  already  installed 

jmp 

short  noinerr 

/output  Error-Message  and  terminate 

badpara : 

mov 

dx, offset  badp 

/Error-Message:  invalid  parameter 

noinerr: 

mov 

al,l 

/Error-Code 

jmp 

showend 

/teiminate  program 

install: 

dtp 

extkey,  0 

/Key-code  discovered? 

jne 

badpara 

/NO  — >  Error 

mov 

ax,3516h 

/get  content  of  interrupt  vector  16 

int 

21h 

/call  DOS-f unction 
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anp 

word  ptr  es: 

[bx+2]. 

“TM"  ;test  if  already  Installed 

je 

alllnst 

;YES  — >  Error 

mov 

lntaltseg,es 

/segment  and  offset  address  of  the 

mov 

intaltofs,bx 

/stored-interrupt  vector  16(h) 

mov 

dx, offset  newint 

/Offset  address  new  interrupt  routine 

mov 

ax,2516h 

/change  content  interrupt  vector  16 

int 

21h 

/to  user  routine 

mov 

dx, offset  installm 

/Message:  program  installed 

mov 

ah,  9 

/output  function  number  for  string 

int 

21h 

/call  DOS-f unction 

only  the  PSP, 

the  new  interrupt-Routlne  and  the  - 

; — 

Data  must  remain  resident. 

mov 

dx, offset  instend 

/calculate  number  of  paragraphs 

mov 

cl,  4 

/  (each  16  Bytes)  at  the  disposal 

shr 

dx,cl 

/  of  the  program 

Inc 

dx 

mov 

ax,3100h 

/terminate  program  with  End-Code  0 

int 

21h 

/remain  resident 

showend: 

mov 

ah,  9 

/output  string 

int 

21h 

/call  DOS-f unction 

mov 

ah, 4Ch 

/function  number  for  program 

int 

21h 

/terminate  program  with  End-Code 

showlnlt 

endp 

/End  of  PROG-procedure 

ASCIIBIN: 

convert  ASCII 

number  to  binary  (max.  16  Bit)  - 

; —  Input 

: 

DS:SI  “  Address  of 

Number  as  ASCII-string 

; —  Output  : 

AX  “  the  converted 

Number 

; — 

Carry-Flag  = 

1  ;  Number  too  large 

; —  Register  : 

AX,  BX,  CX, 

SI  and 

FLAGS  are  changed 

; —  Info 

• 

the  ASCII-string  must  be  ended  with  Code  0 

asciibin 

proc 

near 

xor 

bh,bh 

/Hi-Byte  of  every  position 

mov 

cx,10 

/we  use  decimal  system 

xor 

ax,  ax 

/preliminary  result 

nx  num: 

mov 

bl, [si] 

/get  next  number 

or 

bl,bl 

/NUL-Code  (End)? 

je 

ab  ende 

/YES  — >  number  converted 

dip 

bl,'*0'* 

/test  if  number 

jb 

ab  ret 

/NO  — >  Error 

cmp 

bl, -9" 

/test  if  number 

ja 

ab  err 

/NO  — >  Error 

mul 

CX 

/preliminary  Number  *  10 

jc 

ab  ret 

/Number  >  65535  — >  Error 

and 

bl, 1111b 

/convert  number  to  binary 

add 

ax,bx 

/add  to  preliminary  Number 

inc 

si 

/process  next  number 

jmp 

short  nx_num 

ab  ende: 

clc 

/no  Error 

ret 

/bac)c  to  caller 

ab  err: 

stc 

/Error 

ab_ret : 

ret 

/back  to  caller 

asciibin 

endp 

PARMTEST: 

capture  Parameter  in  the  Command  Line  - 

; —  Input 

: 

DS:0000  «  Address  of  PSP 

;  —  Output  : 

DL  “  number  of  parameters  found 

; —  Register  : 

AX,  CX,  DX, 

SI  and 

FLAGS  are  changed 
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; —  Info 

: 

Address  of  every  parameter  is  stored  in  Array-PARTAB  as 

; — 

Offset  address  to 

DS.  In  addition  behind  every 

; — 

parameter  an  ASCII 

-Code  0  is  stored. 

parmtest 

proc 

near 

cld 

;on  string  ccxnmands  count  up 

xor 

dx,dx 

/number  of  parameters  found 

mov 

si,80h 

/address  where  number  of  characters 
/of  the  command  line  is  stored  in  PSP 

mov 

cl, byte  ptr  [si] 

/get  number  of  character 

or 

cl,  cl 

/have  parameters  been  passed? 

je 

parmtend 

/NO  — >  End 

inc 

si 

/SI  points  to  start  of  command  line 

xor 

ch,  ch 

/in  CX  is  the  number  of  characters 

getez: 

lodsb 

/move  next  character  to  AL 

anp 

al,"  •• 

/is  it  a  space  ? 

je 

space 

/YES  ~>  SPACE 

anp 

al,TAB 

/is  it  a  Tab-character? 

je 

space 

/YES  — >  SPACE 

no  Space  or  Tabulator  - 

or 

dh,  dh 

/was  last  character  space  ? 

jne 

nextz 

/NO  — >  process  next  character 

inc 

dl 

/increment  number  parameters  found 

not 

dh 

/indicates  no  •*  "  or  TAB 

mov 

ax,  si 

/calculate  address  of 

dec 

ax 

/ parameter 

stosw 

/store  in  parameter-Table 

next  z : 

loop  getez 

/get  next  character 

mov 

byte  ptr  [si],0 

/NUL-character  as  parameter-End 

parmtend: 

ret 

/back  to  caller 

space: 

or 

dh,dh 

/was  last  character  space  character? 

je 

nextz 

/YES  — >  process  next  character 

; —  found  next  parameter 


xor 

mov 

jmp 

dh,dh 

byte  ptr  [si-l],0 
short  nextz 

/this  character  was  a  space 
/NUL-character  as  parameter-End 
/process  next  character 

parmtest 

m  — — »  TTnH  ~ 

endp 

/  CinQ  - 

code 

ends 

end 

start 

/End  of  CODE-Segment 

Program  flow 

The  file  header  describes  the  DOS  call  of  the  program.  As  mentioned  above,  there 
are  two  basic  options  for  the  call:  If  you  call  the  program  without  parameters  in 
the  command  line,  it  tries  to  remove  any  previously  installed  SHOWCLK.  If  you 
call  the  program  with  parameters,  SHOWCLK  installs  itself.  The  first  parameter 
must  be  the  scan  code  which  the  user  wants  to  trigger  the  clock  display.  The  line 
and  column  parameters  indicate  the  clock  display  area  on  the  screen.  If  these  two 
parameters  are  missing,  the  clock  appears  in  the  upper  right  hand  corner  of  the 
screen. 
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The  constant  definition  follows  the  file  header  to  ease  your  reading  of  the  listing. 

The  code  segment  definition  follows,  which  accepts  the  program  code  and  the  data. 
The  ORG  lOOH  instruction,  which  places  the  beginning  of  the  program  at  address 
lOOH,  indicates  that  SHOWCLK  is  a  COM  program.  A  COM  program  is  a  good 
choice  for  a  resident  interrupt  driver  because  of  the  compactness  of  having  data, 
code  and  stack  in  one  segment. 

The  label  START  shows  the  first  executable  instruction  of  the  program.  It  jumps 
first  to  the  installation  routine  of  SHOWCLK  which  has  the  name  SHOWINIT. 

This  routine  loads  the  address  of  a  table  and  calls  the  procedure  PARMTEST.  It 
counts  the  number  of  arguments  passed  in  the  command  line  and  stores  the  starting 
addresses  of  the  individual  parameters  into  the  passed  table.  After  this  procedure 
ends,  SHOWINIT  tests  whether  parameters  were  passed  in  the  command  line.  If 
this  is  not  the  case,  it  jumps  to  DEACTIVATE  which  removes  the  old 
SHOWCLK  from  memory. 

Assuming  that  arguments  were  passed  to  SHOWCLK  in  the  command  line, 
SHOWINIT  now  reads  the  passed  parameters  and  tests  them  for  accuracy.  If  it  finds 
a  correct  key  code,  this  code  passes  to  the  KEYCODE  variable.  If  the  indication  of 
a  line  or  column  is  found,  it's  tested  for  an  acceptable  value.  If  YES,  it  moves  to 
the  COLUMN  or  LINE  variable.  If  an  error  and  unknown  parameter  or  an  illegal 
coordinate  occurs  during  the  argument  checking,  the  program  ends  with  an  error 
code.  If  the  parameters  evaluated  are  correct,  a  jump  goes  to  the  label  INSTALL.  A 
test  searches  for  a  keyboard  code.  If  no  keyboard  code  exists,  the  program  ends  with 
an  error  message.  If  it's  available,  the  program  first  tests  if  SHOWCLK  is  already 
installed. 

DOS  function  35H  determines  the  address  of  the  BIOS  keyboard  interrupt  (the 
interrupt  pointing  to  a  user  routine).  It  returns  the  segment  address  of  the  interrupt 
routine  in  ES,  and  the  offset  address  in  the  BX  register.  If  SHOWCLK  was  already 
installed,  an  interrupt  routine  must  be  located  at  this  address  which  is  constructed 
exactly  like  the  interrupt  routine  which  is  installed,  since  SHOWCLK  always 
installs  the  same  interrupt  routine. 

The  routine  starts  with  a  2-byte  jump  instruction  to  the  routine  itself.  An 
identification  code  follows,  consisting  of  two  ASCII  characters,  which  can  be  the 
initials  of  the  author.  In  this  case  the  initials  are  MT.  INSTALL  tests  the  address 
of  the  interrupt  routine  plus  2  for  the  ASCII  codes  of  the  initials  MT.  The  test  is 
not  for  MT,  but  for  TM,  since  the  low  byte  is  always  stored  before  the  high  byte. 
If  the  code  exists,  SHOWCLK  is  already  installed  and  the  program  terminates  with 
an  error  message.  If  INSTALL  finds  another  bit  pattern,  it  means  that  no  previous 
version  of  SHOWCLK  existed.  INSTALL  can  then  proceed  with  installation. 
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Installing  SHOWCLK 

First  INSTALL  stores  the  address  of  the  old  intarupt  routine  in  the  INTALTOFS 
and  INTALTSEG  variables.  Next  the  int^rupt  16H  points  through  DOS  function 
25H  to  the  NEWINT  routine.  The  new  interrupt  routine  of  interrupt  16H  is  called 
if  a  program  wants  to  call  one  of  the  three  functions  of  this  interrupt.  A  message 
tells  the  user  that  the  program  is  now  installed,  and  the  DOS  prompt  returns.  It's 
important  that  DOS  not  release  the  memory  occupied  by  SHOWCLK  for  other 
programs.  This  could  result  in  another  program  overwriting  the  new  interrupt 
routine,  and  a  system  crash  during  the  c^l  of  interrupt  16H.  To  prevent  this,  the 
program  terminates  with  a  DOS  function  which  makes  a  portion  of  this  program 
resident  and  prevents  overwriting  by  other  programs.  Function  31H  must  be 
informed  how  many  16-byte  paragraphs  must  be  protected,  starting  from  the 
beginning  of  the  PSP. 

Protecting  memory 

Once  installed,  the  new  interrupt  routine  must  stay  protected  from  changes  that 
other  registers  could  make  to  it.  At  the  same  time,  SHOWCLK's  installation 
routine  must  remain  unprotected.  SHOWCLK  places  the  interrupt  routine  before 
the  installation  routine.  Only  the  number  of  bytes  between  the  beginning  of  the 
PSP  and  the  last  byte  of  the  interrupt  routine,  converted  into  paragraphs,  must  be 
passed  to  function  32H.  The  new  interrupt  routine  cannot  be  overwritten. 

This  interrupt  routine  must  also  contain  variables.  They  are  stored  between  the 
program  start  instruction  and  the  interrupt  routine  code  proper.  This  ensures  that 
the  variables  remain  resident  in  memory.  At  the  beginning  of  the  interrupt  routine 
(NEWINT)  is  a  jump  instruction  followed  by  the  identification  code.  When  a 
program  calls  interrupt  16H,  a  jump  occurs  directly  to  label  NEWI__1.  NEWLl 
tests  for  whether  the  function  number  passed  to  interrupt  16H  in  the  AH  register  is 
0.  This  is  the  only  function  applicable  to  this  program,  since  the  function  reads 
characters  from  the  keyboard  buffer.  If  you  called  one  of  the  two  other  functions, 
the  program  calls  the  old  interrupt  16H  and  passes  control  to  the  calling  program. 
If  function  0  is  called,  it  reads  a  character  from  the  keyboard  with  the  old  keyboard 
interrupt  The  program  then  compares  this  character  with  the  key  indicated  when 
the  program  call  occurred.  If  this  is  not  the  case,  control  returns  to  the  calling 
program.  If  it  was  the  indicated  key,  preparations  begin  to  display  the  time  on  the 
saeen. 

Stack  activity 

First  the  contents  of  all  registers  which  change  during  the  course  of  the  program 
are  stored  on  the  stack  so  they  can  be  restored  to  the  calling  program.  Then  the  five 
characters  of  the  display  in  the  position  where  the  time  appears  are  read  from  the 
screen  and  stored.  DOS  function  2CH  reads  the  time  and  converts  it  to  an  ASCII 
string  for  display.  After  the  time  appears  on  the  scre^,  the  old  keyboard  intorupt 
waits  for  a  keypress.  When  this  occurs,  the  characters  formerly  located  where  the 
time  appears  return  to  their  old  positions.  The  registo's  return  from  the  stack  and 
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the  inx)gram  jumps  to  the  beginning  of  the  routine  to  read  in  a  key,  display  the 
time  again,  or  pass  the  key  to  the  calling  program. 

Deactivating  SHOWCLK 

The  last  component  to  be  examined  is  the  program  routine  called  when 
SHOWCLK  is  removed  from  memory.  The  installation  routine  calls  it  if  no 
parameto'  was  passed  in  the  command  line  and  begins  with  the  DEACTIVATE 
label.  The  routine  tests  for  whether  SHOWCLK  is  already  installed.  If  this  isn't 
the  case,  it  cannot  be  removed,  and  the  program  trnninates  with  an  error  message. 
If  SHOWCLK  was  already  installed,  the  keyboard  interrupt  must  point  to  the  old 
interrupt  routine.  The  memory  containing  the  old  SHOWCLK  routine  must  be 
released. 

The  problem  is  that  the  new  SHOWCLK,  which  should  remove  the  SHOWCLK 
already  in  memory,  doesn't  know  the  address  of  the  old  interrupt  routine  of 
interrupt  16H.  It's  stored  in  the  old  SHOWCLK  in  the  variables  BNTALTOFS  and 
INTALTSEG.  Hie  two  variables  are  in  completely  different  programs,  but  there  is 
a  simple  method  of  reading  these  variables.  The  old  SHOWCLK  lies  in  a  different 
memory  segment  from  the  new  SHOWCLK,  but  the  offset  addresses  of  the 
variables  and  routines  in  both  programs  are  identical.  Since  you  know  the  segment 
address  of  the  old  SHOWCLK  (the  segment  address  of  the  interrupt  routine),  the 
contents  of  the  variables  INTALTOFS  and  INTALTSEG  can  be  read  from  the  old 
SHOWCLK  and  the  interrupt  16H  can  again  point  to  the  original  interrupt  routine. 
Memory  can  be  released  again  through  the  segment  address  of  the  old  SHOWCLK 
routine  with  the  help  of  DOS  function  49H.  This  concludes  the  task  of 
DECACnVATE  and  the  program  can  tominate  after  displaying  a  message. 

Examine  the  listing  step  by  step  and  read  the  comments  carefully.  This  is 
important,  because  the  program  can  serve  as  a  basic  framewodr  for  any  resident 
interrupt  driver.  We'll  discuss  another  form  of  resident  {n'Ogram  (the  TSR 
program)  in  Chapter  8. 
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7.12  Accessing  the  Printer  from  the  BIOS 

BIOS  offers  three  functions,  called  by  interrupt  17H,  for  conununicating  with  one 
or  more  printos  interfaced  to  the  PC.  These  functions  have  an  advantage  over  the 
DOS  printer  output  functions:  They  can  specify  the  printer  to  which  the  output 
should  go.  The  printer's  numb^  (0, 1  or  2)  must  be  loaded  into  the  DX  register 
during  the  function  call.  After  each  of  the  three  function  calls,  the  printer  status 
passes  to  the  AH  register.  Each  bit  in  this  status  byte  provides  information  about 
the  printer's  task,  whether  it  still  has  paper,  etc. 


Printer  status  byte 


Time  out 

A  time  out  error  occurs  wh^  BIOS  tries  to  send  data  for  a  cotain  amount  of  time 
to  the  printa,  but  the  printer  refuses  the  data  and  returns  a  busy  message  (bit  7 
becomes  0).  The  numter  of  tries  BIOS  makes  before  signaling  a  time  out  error 
depends  on  the  contents  of  address  0040:0078  in  RAM.  ROM  uses  this  address  for 
storing  variables.  The  value  20  which  BIOS  enters  into  these  memory  locations 
during  the  system  boot  is  different  from  the  repeat  factor  of  20.  The  value  in  these 
memory  locations  must  be  multiplied  first  by  4,  then  by  65,536.  A  value  of  20 
actually  ref^  to  5  million  attempts.  This  number  is  relative  since  the  loop  which 
checks  the  printer  has  only  a  few  assembly  language  instructions  processed  very 
quickly  by  the  CPU.  This  results  in  a  waiting  period  of  only  a  few  seconds  before 
the  BIOS  reports  a  time  out  error.  If  working  with  the  BIOS  routine  seems  to 
create  more  time  out  errors  than  usual,  try  increasing  the  value  in  the  memory 
locations  mentioned  above  so  that  BIOS  makes  more  attempts.  This  may  help 
communication  between  BIOS  and  the  printer. 

Various  printer  conditions  can  change  a  series  of  bits  in  the  status  byte.  An  ON 
LINE  (ready  to  print)  prints  sets  bits  7  and  4.  If  the  ymtet  switches  to  OFF  LINE 
(e.g.,  for  page  advance)  then  bit  7  and  bit  4  reset  and  bit  3  sets,  indicating  a 
transmission  error. 
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The  program  must  decide  whether  new  data  should  be  sent  to  the  printer,  whether 
printer  output  should  end  or  further  steps  should  be  taken. 

Function  0:  Send  character 

Function  0  transmits  a  character  to  the  printer.  Load  the  function  number  into  the 
AH  register  and  the  ASCII  code  of  Ae  character  you  want  sent  into  the  AL 
register.  After  the  function  call  the  AH  register  contains  the  status  byte.  If  the 
character  transmission/printing  failed,  the  AH  register  contains  the  value  1. 

Function  1:  Initiaiize  printer 

The  second  function  initializes  the  printer  ports.  You  should  always  execute  this 
function  before  sending  data  to  the  printer  for  the  first  time.  Load  the  function 
number  1  into  the  AH  register;  no  other  arguments  are  required. 

Function  2:  Read  printer  status 

Function  2  loads  the  status  byte  into  the  AH  register.  As  mentioned  above,  the 
status  byte  tells  you  the  current  status  of  the  printer.  Load  the  function  number  2 
into  the  AH  register;  no  other  arguments  are  required. 

Demonstration  programs 

The  programs  listed  in  this  section  use  the  BIOS  printer  interrupt  in  the  same  way 
as  the  programs  listed  earlier  to  demonstrate  the  BIOS  keyboard  interrupt.  The 
three  higher  level  language  programs  listed  here  send  strings  to  a  printer  using  the 
BIOS  printer  intemipL  The  fourth  program  is  an  assembly  language  routine  which 
adapts  the  BIOS  printer  interrupt  to  its  own  routine. 

The  three  higher  level  language  programs  are  similar  in  organization  and  are 
divided  into  five  sections.  One  section  is  the  main  program.  The  other  four 
sections  call  the  various  functions  of  the  BIOS  printer  interrupt.  These  sections 
include  a  routine  for  initializing  a  specific  printer  interface,  a  routine  for  character 
or  string  output  and  a  routine  which  displays  an  error  message  on  the  screen  if 
needed.  The  main  program  initializes  printer  interface  0,  then  prints  a  test  string  on 
the  printer  connected  to  this  interface.  If  an  error  occurs  during  one  of  these  two 
operations,  an  error  message  is  displayed  on  the  monitor.  This  message  can  be 
delayed  if  no  printer  is  attached  to  the  PC,  since  BIOS  continues  addressing  the 
printer,  and  gives  up  after  a  few  attempts.  If  nothing  happens  for  some  time,  don’t 
panic.  The  program  will  eventually  report  its  error  status. 
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BASIC 


listing:  PRINTB.BAS 


100  *******  ***********-kit  ************ -kicickltltltlckickltltltlck-klck-klcklck  ******  1f*1t  It  * 

110'*  PRINTS  ** 

120  - *• 


Task 


Author 
developed  on 
last  Update 


makes  a  subroutine  available  for  sending 
strings  to  a  printer  and  ** 

registering  errors  during  the  output  to  the  ** 

printer  * ' 

MICHAEL  TISCHER  *' 

7/22/87  *• 

9/21/87 


130 
140 
150 
160 
170 
180 
190 
200 
210  • 

220  CLS  :  KEY  OFF 

230  PRINT-WARNING:  This  program  should  be  started  only  if  GWBASIC  was  - 
240  PRINT-started  from  the  DOS  level  with  <GWBASIC  /m:60000>.- 
250  PRINT  :  PRINT-If  this  is  not  the  case,  please  input  <s>  for  Stop.- 
260  PRINT-Otherwise  press  any  key...-; 

270  A$  »  INKEY$  :  IF  A$  -  -s-  THEN  END 
280  IF  A$  »  THEN  270 

290  GOSUB  60000  'install  Function  for  Interrupt -Call 

300  CLS  'Clear  Screen 

310  PRINT-PRINT  (c)  1987  by  Michael  Tischer-  :  PRINT 

320  PRINT" If  a  parallel  printer  is  interfaced  to  your  PC,  the  - 

330  PRINT- following  text  should  af^ar  on  it  immediately:-  :  PRINT 

340  PRINT-a  test  of  the  printer  routines..."  :  PRINT 

350  PRINT"If  not,  an  error  message  will  be  output."  :  PRINT 

360  PRINTER%  *  0  'address  the  first  Printer  on  the  PC 

370  GOSUB  50000  'initialize  Printer 

380  GOSUB  53000  'output  message 

390  T$  =  "a  test  of  the  printer  routines. . .-+CHR$ (13) +CHR$ (10) 

400  GOSUB  51000  'output  String  on  the  Printer 

410  GOSUB  53000  'output  Message 

420  PRINT 

430  END 

440  ' 

50000  '********★****★**♦**★**★***★**************★***********★*****♦***' 
50010  '*  initialize  one  of  the  Printer  interfaces  *' 

50020  '* - *' 

50030 
50040 
50050 
50060 
50070 
50080 
50090 
50100 
50110 
50120 
50130 
50140 
51000 
51010 
51020 
51030 
51040 
51050 
51060 
51070 
51080 
51090 
51100 
51110 
51120 
51130 
51140 
52000 
52010 


**  Input:  PRINTER%  =  the  Number  of  the  Printer  to  be  addressed  ** 
'*  Output:  DS%  is  the  Status  of  the  Printer  *' 

'*  Info  :  the  Variable  Z%  is  used  as  Dummy  *' 

•  *************************************************************** * 

PRTHI%  =  0  'Hi-Byte  of  the  Printer  number 

FKT%*2  'initialize  Function  number  for  Interface 

INR%=&H17  'call  BI OS-Print er-Interrupt  17(h) 

CALL  lA (INR%, FKT%, Z%, Z%, Z%, Z%, Z%, PRTHI%, PRINTER%, Z%, Z%, Z%, Z%) 

DS%  =  FKT%  AND  fiH21  'store  Printer  status  in  DS% 

RETURN  'back  to  Caller 

***************************************************************** 

'*  send  a  String  to  one  of  the  Printers  *' 

•  ★ _ *  • 

'*  Input:  T$  *  the  String  to  be  output  ** 

'*  PRINTER%  *  the  Number  of  the  Printer  *' 

'*  Output:  the  Variable  DS%  contains  the  Printer  status  *' 

*************************■»[*************************************** 
I 

FOR  I  *  1  TO  LEN(T$)  'process  all  characters  of  the  string 
Z$  “  MID$(T$, 1,1)  'isolate  one  character  from  the  string 

GOSUB  52000  'output  character  on  the  printer 

IF  DS%<>0  THEN  I  »  LEN (T$)  'on  error  terminate  output 

NEXT  I  'process  next  character 

RETURN  'back  to  Caller 

•  ************  ********-it  ********************************  ********** * 

**  send  a  Character  to  one  of  the  Printers  *' 
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52020  •* - *' 

52030  Input:  Z$  *  the  Character  to  be  output  *' 

52040  •*  PRINTER%  *  the  Number  of  the  Printer  *' 

52050  '*  Output:  the  Variable  DS%  contains  Printer  status  (0-o.k.)  *' 

52060  '*  Info  :  the  Variable  Z%  is  used  as  a  Dummy  *' 

52070  ***************************************************************** 

52080  • 

52090  CHARACTER%  »  ASC (Z$)  'the  ASCII-Code  of  the  Character 

52100  FKT%=0  'print  Function  number  for  Character 

52110  INR%-&H17  'call  BlOS-Printer-Interrupt  17(h) 

52120  CALL  lA (INR%, FKT%, CHARACTER%, Z%, Z%, Z%, Z%,  PRTHI%, PRINTER%, Z%, Z%, Z%, Z%) 
52130  DS%  =  Ficr%  AND  &H21  'record  Printer  status  in  DS% 

52140  RETURN  'back  to  Caller 

52150  ' 

53000  ***************************************************************** 

53010  **  Output  an  error-message  on  the  basis  of  the  Printer-Status  *' 

53020  •* - *' 

53030  **  Input:  DS%  =  the  Printer  status  *' 

53040  **  Output:  none  *' 

53050  '*  Info  :  if  the  Printer  status  is  o.k.,  no  output  *' 

53060  ***************************************************************** 

53070  ' 

53080  IF  DS%  -  0  THEN  RETURN  'everything  o.k.  — >  back  to  Caller 
53090  PRINT"Error  on  access  to  Printer: 

53100  IF  (DS%  AND  1)  <>  0  THEN  PRINT "Time-Out-Error"  :  RETURN 
53110  IF  (DS%  AND  8)  <>  0  THEN  PRINT"I/0  Error"  :  RETURN 
53120  IF  (DS%  AND  32)  <>  0  THEN  PRINT"no  more  paper  "  :  RETURN 
53130  PRINT"Error  type  unknown"  :  RETURN 
53140  • 

60000  ***************************************************************** 

60010  '*  initialize  the  Routine  for  Interrupt -Call  *' 

60020  '* - *' 

60030  '*  Input:  none  *' 

60040  '*  Output:  lA  is  the  Start  address  of  the  Interrupt -Routine  *' 

60050  ***************************************************************** 

60060  • 

60070  IA=60000!  'Start  address  of  the  Routine  in  the  BASIC-Segment 

60080  DEF  SEG  'set  BASIC-Segment 

60090  RESTORE  60130 

60100  FOR  1%  =  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'poke  Routine 
60110  RETURN  'back  to  Caller 

60120  • 

60130  DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

60140  DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

60150  DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

60160  DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 

60170  DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,118,  10 

60180  DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

60190  DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

60200  DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

60210  DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

60220  DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

60230  DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 
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Pascal  listing:  PRINTP.PAS 

^ ********************* **^^****************** ******************** *******! 


{*  PRINT?  *} 

(* - - - *j 

{*  Task  :  Makes  a  function  available  for  sending  *} 

{*  strings  to  a  printer  and  registers  *} 

{*  errors  during  the  output  to  the  printer  *} 

I* - *j 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  on  :  7/9/87  *} 

{*  'last  Update  :  6/09/89  *} 


!*********************************************************************! 
program  PRINTP Pa¬ 
uses  Crt,  Dos; 
i$V-} 

type  Output  =  string [255]; 
var  Print Error  :  byte;  {  Printer  error  code  } 

!*********************************************************************! 


{*  PRINTCHARACTER:  sends  a  character  to  the  printer  *} 
{*  Input  ;  see  below  *} 
{*  Output  :  TRUE  if  an  error  occurred,  else  FALSE  *} 
{*  Info  :  if  an  error  is  discovered,  the  status  of  the  printer  is  *} 
{*  stored  in  the  global  variable  PRINTERROR  *} 


I  ***************************************************************** ****j 

function  PrintCharacter (Character  :  char;  {  Character  to  be  output  } 
Printer  :  integer)  ;  boolean;  {  Nr.  of  Printer  } 

var  Regs  :  Registers;  {  Register  variable  for  interrupt  call  } 

begin 

Regs. ah  :=  0; 

Regs.al  ;=  ord (Character) ; 

Regs.dx  ;=  Printer; 
intr($17,  Regs) ; 
if  (Regs. ah  and  $21)  o  0  then 
begin 

PrintCharacter  :=  false; 

PrintError  :=  Regs. ah; 
end 

else  PrintCharacter  :=  true 
end; 

I ********************************************************************* j 

{*  PRINTSTRING:  sends  a  string  to  the  selected  printer  *} 

{*  Input  :  see  below  *} 

(*  Output  :  TRUE  if  no  error  occurred,  else  FALSE  *} 

I ********************************************************************* j 

function  Printstring (Text  :  Output;  {  the  string  to  be  output  } 

Printer  :  integer)  :  boolean; {  Number  of  printer  } 

var  Counter  :  integer;  {  loop  counter  ) 

Ok  :  boolean;  {  Result  of  the  PRINTCHARACTER  function  ) 

begin 

Counter  :=  1;  {  begin  with  the  first  character  in  the  string  } 

repeat 

Ok  :=  PrintCharacter (Text [Counter] ,  Printer);  {  Print  a  character  } 
Counter  :=  succ (Counter)  {  Process  next  character  } 

until  not (Ok)  or  (Counter  >  length (Text) ) ;  {  Terminate  on  error  } 

Printstring  :=  Ok;  {  Set  result  of  the  function  } 


{  Function  number  &  code  of  character  } 
(  Printer  number  } 
{  Call  BIOS  printer  interrupt  } 
{  Did  an  error  occur?  } 
{  YES  } 
{  Display  error  } 
{  Record  error  code  ] 

{  No  error  ] 


{  Add  Crt  and  Dos  units  } 
{  Don't  test  string  length  } 
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end; 


{*  INITPRINTER:  initializes  the  printer  interface 

{*  Input  ;  see  below  *) 
{*  Output  :  true,  if  no  error  occurred,  otherwise  false  *} 
{*  Info  :  if  an  Error  is  detected,  the  Status  of  the  Printer  is  *} 
{*  stored  in  the  global  Variable  PRINTERROR  *} 


function  InitPrinter (Printer  :  integer)  :  boolean;  {  Printer  number  } 
var  Regs  :  Registers;  {  Register  variables  for  interrupt  call  } 


begin 

Regs. ah  :»  $2; 

Regs.dx  ;=  Printer; 
intr($17,  Regs); 
if  (Regs. ah  and  $21)  <>  0  then 
begin 

InitPrinter  :*  false; 
PrintError  :»  Regs. ah; 
end 

else  InitPrinter  :=  true 
end; 


{  Function  number  for  Init  } 
{  Printer  number  } 
{  Call  BIOS  printer  interrupt  } 
{  Did  an  error  occur  ?  } 
{  YES  } 
{  Display  error  } 
{  Record  error  code  } 

{  No  error  } 


{*  PRINTERROR:  outputs  error  message 
{*  Input  :  none 

Output  :  none  *} 

{*  Info  :  the  error  message  is  displayed  according  to  the  content 
(1^  of  the  variable 

{ *  PRINTERROR  * } 

j ★**★**★★******★*★★*★★★★*★★★★******★*★★★*★★*★**★*★★***★★★ ★★★★*★★★★**★★} 


procedure  PrinterError; 
begin 

write ('Error  during  printer  access:  '); 
if  PrintError  and  1  <>  0 
then  write In ( ' Time-Out  Error ' ) 
else  if  PrintError  and  8  <>  0 
then  writeln('I/0  Error') 
else  if  PrintError  and  32  <>  0 
then  writelnCout  of  paper') 
else  writelnC Error  unknown'); 

end; 


{  Time  out  error?  } 
{  YES  } 
{  I/O  error?  } 
{  YES  } 
{  No  more  paper  ?  } 
{  YES  } 


{*  MAIN  PROGRAM  *] 


begin 

clrscr;  {  Clear  screen  } 

writelnC  PRINT  (c)  1987  by  Michael  Tischer' )  ; 

writeln(#13#10'If  a  printer  is  interfaced  to  the  parallel  interface  '+ 
' 0  of  the  PC,  ' ) ; 

writelnC the  following  text  should  now  appear  on  this  '+ 

'printer: ' ) ; 

writeln(#13#10'a  test  of  the  printer  routines. ..' #13#10) ; 
writeln( 'Otherwise  the  program  will  display  an  error  message  !'); 
writeln; 

if  InitPrinter (0)  then  {  Initialize  printer  interface  0  } 

begin 

if  Printstring ('a  test  of  the  printer  routines. ..' #13#10,  0) 
then  writelnCall  o.k.') 

else  PrinterError  {  display  error  message  } 

end  {  Initialization  error  } 

else  PrinterError;  {  display  error  message  } 

end. 
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C  listing:  PRINTC.C 


/*********★******** ***************************************** *★*****★/ 

*/ 
/ 
/ 


★ 

P  R  I  N  T  C 

★ 

’* 

Task  : 

Makes  a  function  available  for  sending  a 

★ 

string  to  a  printer.  If  any  errors  occur 

★ 

’* 

during  printing,  the  program  will  display 

★ 

'* 

errors  on  the  screen 

* 

'* 

Author 

:  MICHAEL  TISCHER 

* 

'* 

developed  on 

:  8/13/87 

* 

'* 

last  update 

:  6/09/89 

* 

_* 

'* 

(MICROSOFT  C) 

* 

'* 

Creation 

:  MSC  PRINTC 

* 

’* 

LINK  PRINTC; 

* 

'* 

'*— 

Call 

:  PRINTC 

* 

—* 

/* 

/* 

/  *★  * 


(BORLAND  TURBO  C) 

Creation  :  with  the  RUN  coimiand  in  the  command  line 

*********  itit****-k*******-k-k-k-k******-k*****-k***********itit******i 


*/ 

*/ 

****  / 


♦include  <dos.h>  /*  include  header  files  */ 

♦include  <io.h> 

/*a«  Type  definitions  “===**=*=s====«==*=«==«==========*===»=*»*®**/ 

typedef  unsigned  char  byte;  /*  Create  a  byte  */ 

♦define  FALSE  0  /*  Constants  make  reading  of  the  */ 

♦define  TRUE  1  /*  program  text  easier  */ 

/********************************************************************/ 
/*  PRINTERROR:  displays  error  message  */ 

/*  Input  :  0  stands  for  o.k.,  else  error  code  */ 

/*  Output  :  TRUE  if  no  error  is  displayed,  else  FALSE  */ 

/********************************************************************/ 


byte  PrintError  (Status) 


int  Status; 

/*  Printer  status 

*/ 

{ 

if  (Status) 

/*  Did  an  error  occur  ? 

*/ 

{ 

printf ("Error  during  printer  access:"); 

/*  YES 

*/ 

if  (Status  &  1) 

/*  Time-Out  Error? 

*/ 

printf  ("Time-Out  Error\n") ; 

/*  YES 

*/ 

else  if  (Status  &  8) 

/*  I/O  error? 

*/ 

printf ("I/O  errorXn") ; 

/*  YES 

*/ 

else  if  (Status  &  32) 

/*  No  more  paper  ? 

*/ 

printf ("no  more  paper\n") ; 

/*  YES 

*/ 

else  print f ("Error  unknownXn"); 
return  (FALSE) ; 

} 

else  return (TRUE) ;  /*  Error  detected  */ 

} 


/********************************************************************/ 


/*  PRINTCHARACTER:  sends  a  character  to  the  printer  */ 
/*  Input  :  see  below  */ 
/*  Output  :  FALSE  if  no  error  occurred,  else  */ 
/*  error  number  */ 


/********************************************************************/ 


byte  PrintCharacter (Character,  Printer) 

char  Character;  /*  The  character  for  output  */ 

unsigned  int  Printer;  /*  Number  of  the  designated  printer  */ 

( 
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union  REGS  Register;  /*  Register  variables  for  interrupt  call  */ 

Register. h. ah  -  0;  /*  Function  number  for  character  printing  */ 

Register. h.al  »  Character;  /*  Character  code  */ 

Register. x.dx  =  Printer;  /*  Printer  number  */ 

int86(0xl7,  ^Register,  ^Register) ;  /*  call  BIOS  printer  interrupt  */ 

return (Register.h. ah  &  0x29);  /*  Leave  only  error  bits  */ 

} 

/it***********  ********1111****  *******  It****  ************  ******************/ 


/*  PRINTSTRING:  sends  a  string  to  the  selected  printer  */ 
/*  Input  :  see  below  */ 
/*  Output  :  FALSE,  if  no  error  occurred,  else  */ 
/*  error  number  */ 


/★★★★★★★**★***★★*★***★★*★★*★★★★★★*★★★**★★****★**★★★★★★★★★★★**★★*★**★★/ 
byte  Print St ring (Text,  Printer) 

char  *Text;  /*  String  to  be  output  (character  vector)  */ 

unsigned  int  Printer;  /*  Number  of  the  printer  */ 

{ 

byte  Status;  /*  The  printer  status  */ 

Status  *  FALSE;  /*  Initialize  if  string  is  ert^ty  */ 

/*  Output  string  until  end  is  reached  or  error  occurs  during  output*/ 
while  (*Text  &&  ! (Status  -  PrintCharacter (*Text++,  Printer))) 


return (Status) ; 

} 

/******************************************************************** / 


/*  INITPRINTER:  initialize  the  printer  interface  */ 
/*  Input  :  see  below  */ 
/*  Output  :  FALSE  if  no  error  occurred,  else  */ 
/*  error  number  */ 


/******************************************************************** / 


byte  InitPrinter (Printer) 

int  Printer;  /*  Printer  interface  to  be  initialized  */ 


{ 

union  REGS  Register;  /*  Register  variables  for  interrupt  call  */ 


Register.h. ah  =  2; 

Register. x.dx  =  Printer  ; 
int86(0xl7,  ^Register,  ^Register); 
return (Register.h. ah  &  0x29); 

} 


/*  Function  number  for  Init  */ 
/*  Printer/ interface  number  */ 
/*  Call  BIOS  printer  interrupt  */ 
/*  Leave  only  error  bits  */ 


/*******************************************************************/ 
/**  MAIN  PROGRAM  **/ 

/*******************************************************************/ 


void  mainO 


{ 

printf ("\nPRINT  (c)  1987  by  Michael  TischerXnXn") ; 

printfC'If  a  parallel  printer  is  interfaced  to  this  PCXn**)  ; 

printf  ("  the  following  text  should  appear  soon:\n\n") ; 

printf ("a  test  of  the  printer  routines. . .\n\notherwise  "); 

printf ("an  error  message  is  displayed  on  the  monitor  screen. \n\n" ) ; 

if  (PrintError (InitPrinter (0) ) ) 

PrintError (Printstring ("a  test  of  the  printer  routines. ..\r\n"),0); 


} 
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The  assembly  language  program  listed  below  is  a  resident  interrupt  driver.  It  can 
help  the  user  whose  printer  runs  a  character  set  other  than  the  PC  standard.  This  is 
true  of  some  Epson  printers,  whose  foreign  characters  are  different  from  the  PC 
ASCII  character  set  The  program  converts  these  characters  before  sending  them  to 
the  printer  by  turning  the  BIOS  printer  interrupt  to  its  own  routine,  which  is  called 
every  time  the  BIOS  printer  interrupt  is  called. 

It  tests  for  whether  or  not  function  0  (character  output  to  a  printer)  should  be 
called,  because  only  this  function  changes.  If  not,  the  call  passes  to  the  old  printer 
interrupt. 

If  a  character  should  be  output,  the  interrupt  looks  into  a  table,  with  the  name 
CODETAB,  for  the  character.  This  table  consists  of  2-byte  entries.  The  first  (low) 
byte  contains  the  new  code  of  the  character  to  be  converted.  The  second  (high)  byte 
contains  the  old  character  code.  The  table  ends  with  a  byte  containing  the  value  0. 

The  routine  checks  the  second  byte  of  a  table  entry  if  it  is  identical  to  the  character 
to  be  printed.  If  the  character  cannot  be  found  in  the  table,  it  passes  unchanged 
through  the  old  printer  interrupt  for  output.  If  the  character  exists  in  the  table,  it  is 
replaced  by  the  first  byte  of  the  current  entry,  then  sent  for  output  using  the  old 
printer  interrupt. 

This  program  has  a  similar  structure  to  the  resident  keyboard  interrupt  driver 
presented  in  Section  7.11.  The  main  difference  between  the  two  programs  lies  in 
the  command  line,  because  PRUM  (the  program  listed  here)  doesn't  pass  any 
parameters.  It  tests  for  an  existing  pre-installed  version  of  itself  when  it  is  called. 
If  no  installed  PRUM  routine  exists,  it  installs  itself.  Otherwise  the  installed 
version  loads  from  disk  or  hard  disk. 

This  program  can  transmit  output  to  the  printer  using  the  BIOS  printer  interrupt  as 
well  as  DOS. 

Assembler  listing:  PRUM. ASM 


*★**★*★*★***★****•★***★★★*★**★*****★*★*****★★*** 

PRUM 

*  * 

* 

* 

Task  : 

Points  the  BIOS  printer  interrupt  to  its  own 

* 

Routine  and  makes  it  possible  for  example 

★ 

★ 

to  convert  IBM-ASCII  to  EPSON. 

★ 

★ 

The  program  is  deactivated  again  on  the 

* 

second  call  and  removed  from  memory. 

★ 

* 

Author 

:  MICHAEL  TISCHER 

* 

* 

developed  on 

:  8/2/87 

* 

★ 

last  update 

:  6/09/89 

_'A' 

* 

assembly 

:  MASM  PRUM; 

* 

LINK  PRUM; 

* 

*_ 

EXE2BIN  PRUM  PRUM.COM 

* 

_* 

Call 

:  PRUM 

★  ★ 

******★*★**********★******★*****★*★*★****★*******; 

;==  Actual  program  starts  here  ================================== 
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code  segment  para  'CODE'  ;Definltlon  of  the  CC®E  segment 

org  lOOh 

assume  cs:code,  ds:code,  es:code,  ssicode 
start:  jmp  prumini  ;the  first  executable  command 

alterint  equ  this  dword  ;01d  interrupt  vector  17(h) 

intaltofs  dw  (?)  /Offset  address  Interrupt  vector  17(h) 

intaltseg  dw  (?)  /Segment  address  Interrupt  vector  17(h) 


/ —  The  following  table  contains  the  new 
/ —  code  followed  by  the  old  code  - 


codetab 


db 

64, 

21 

5 

- > 

0' 

db 

125, 

129 

'U 

- > 

■} 

db 

123, 

132 

'a 

- > 

M 

db 

91, 

142 

'A 

- - - > 

■[ 

db 

124, 

148 

'6 

- > 

■  1 

db 

92, 

153 

'O' 

- > 

'\ 

db 

93, 

154 

■O' 

- > 

•] 

db 

126, 

in 

CM 

CM 

'B' 

- > 

db 

0 

End 

of  the  table 

/-=  this  is  the  new  printer  interrupt  (remains  in  memory) 


newpri  proc  far 

jmp  short  newpri_l 

db  "CW"  /Identification  of  the  program 


newpri  1 : 

or 

ah,  ah 

/print  character  (function  0) ? 

jne 

aint 

/NO  — >  /address  of  the  code  table 

mov 

bl,al 

/store  code  in  BL 

test code: 

lodsw 

/load  old  (AH)  and  new  code  (AL) 

or 

al,al 

/Reached  end  of  table  ? 

je 

not found 

/YES  — >  Code  not  found 

cmp 

ah,bl 

/Is  it  the  code  for  conversion 

jne 

test code 

/NO  — >  continue  to  search  table 

jmp 

short  nreset 

/it  was  a  code  for  conversion 

not found: 

mov 

al,bl 

/move  old  code  to  AL  again 

nreset : 

xor 

ah,  ah 

/set  function  number  0  again 

pop 

ds 

/restore  registers 

pop 

si 

pop 

bx 

popf 

aint : 

jmp 

cs: [alterint] 

/to  old  printer  routine 

newpri 

endp 

instend 

equ  this  byte 

/up  to  this  mem  location  everything  must 

/remain  resident 

/==  Data  (can  be  overwritten  by  DOS)  ======“================ 

installm  db  13,10,"PRUM  (c)  1987  by  Michael  Tischer", 13, 10, 13, 10 

db  "PRUM  was  installed  and  can  be  deactivated  with  ",13,10 
db  "a  new  call", 13, 10, "$" 

removeit  db  "PRUM  was  deactivatedS", 13, 10 

/==  Program  (can  be  overwritten  by  DOS)  ======================= 

/ —  Start  and  Initialization  Routine  - 
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pruminl 


install 


;==  End 
code 


label  near 


mov  ax, 3517h  ;get  content  of  interrupt  vector  17(h) 

int  21h  ;call  DOS  function 

onp  word  ptr  es:  [bx+2] ,  "WC**  ;test  if  PRUM  program 

jne  install  ;SHCWCL  not  installed  — >  INSTALL 


; —  PRUM  was  deactivated 


mov  dx,es:intaltofs 
mov  ax,es:intaltseg 
mov  ds, ax 
mov  ax, 2517h 
int  21h 


; Offset  address  of  interrupt  17 (h) 
/Segment  address  of  interrupt  17(h) 
;to  DS 

/deflect  content  of  the  interrupt 
/vector  17 (h)  to  old  routine 


mov  ah, 49h 
int  21h 


/release  storage  of  old  PRUM 
/again 


push  cs 
pop  ds 


/store  CS  on  stack 
/restore  DS 


mov  dx, offset  removeit  /Message:  Program  removed 

mov  ah, 9  /write  function  number  for  atring 

int  21h  /call  DOS  function 


mov  ax, 4C00h  /terminate  program 

int  21h  /call  function  program  termination 

/--  install  PRUM  - 


label  near 


mov  ax, 3517h 
int  21h 

mov  intaltseg,es 
mov  intaltofs,bx 


/get  content  of  interrupt  vector  17 
/call  DOS  function 
/save  segment-  and  offset  address 
/  of  the  interrupt  vector  17 (h) 


mov  dx, offset  newpri 
mov  ax, 2517h 
int  21h 


/Offset  address  new  interrupt  routine 
/deflect  content  of  interrupt 
/  vector  17  to  user  routine 


mov  dx, offset  installm  /Message:  Program  installed 

mov  ah, 9  /output  function  number  for  string 

int  21h  /call  DOS  function 


/ —  only  the  PSP,  the  new  interrupt  routine  and  the  — 
/ —  data  pertaining  to  it  must  remain  resident.  — 


mov 

mov 

shr 

inc 

mov 

int 


dx, offset  instend 
cl,  4 
dx,  cl 
dx 

ax,3100h 

21h 


/calculate  the  number  of 
/paragraphs  (each  16  bytes)  available 
/  to  the  program 

/end  program  with  end  code  0  (o.k) 
/but  remain  resident 


ends  /End  of  the  CODE  segment 

end  start 
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7.13  Reading  the  Date  and  Time  from  the  BIOS 

The  various  time  functions  of  the  ROM-BIOS  can  be  addressed  through  BIOS 
interrupt  lAH.  The  PC  and  XT  each  have  two  time/date  functions.  The  AT  has 
eight  time/date  functions  available  to  the  user. 

Realtime  clock 

The  enhanced  functions  included  in  the  AT  operate  in  conjunction  with  the  ATs 
battery  powered  realtime  clock  (RTC).  The  redtime  clock  continues  keeping  time 
even  when  the  AT  is  switched  off.  This  clock's  method  of  timdreeping  is  quite 
different  from  PC  and  XT  time.  PC  and  XT  models  measure  time  using  timer 
intoTupt  8H,  which  the  system  calls  about  18.2  times  per  second.  Tim^  intorupt 
8H  remains  independent  of  the  CPU's  clock  frequency.  The  AT  ROM-BIOS 
maintains  control  of  this  interrupt,  but  only  for  maintaining  software 
compatibility  with  the  PC  and  XT.  The  AT  BIOS  receives  the  current  time  from 
the  realtime  clock  accessing  the  CPU. 

Function  OOH:  Get  clock 

Function  number  OOH  gets  the  current  clock  time.  You  can  call  this  function  by 
passing  the  number  (0)  to  the  AH  register.  The  function  loads  the  time  into  the 
CX  and  DX  registers.  These  two  regista^  combine  to  form  a  32-bit  counts  value 
(CX  contains  the  most  significant  16  bits,  while  DX  contains  the  least  significant 
16  bits).  The  BIOS  timer  increments  this  value  by  1  each  time  interrupt  8H  is 
called  (18.2  times  per  second).  The  total  value  is  the  result  of  multiplying  the 
contents  of  CX  register  by  65,536  and  adding  the  contents  of  the  DX  register. 
Dividing  this  value  by  18.2  returns  the  number  of  seconds  elapsed,  which  can  then 
be  converted  into  minutes  and  hours. 

The  AT  interprets  time  differently  from  the  PC  and  XT.  The  PC/XT  BIOS  sets 
this  counter  to  0  during  the  system  booting  process.  Hie  value  returned  is  the  time 
passed  since  the  computer  was  switched  on  (not  the  actual  time).  To  obtain  the 
time,  the  current  time  must  be  converted  to  the  value  corresponding  to  the  counter, 
then  passed  to  the  BIOS  (more  on  this  later).  The  AT  doesn't  require  this  time 
value  conversion  since  BIOS  reads  the  actual  time  from  the  realtime  clock  during 
the  system  boot  It  converts  this  time  into  a  suitable  timer  value  and  saves  it 
Reading  the  counter  with  the  help  of  function  0  on  the  AT  thus  provides  the 
current  time. 

Besides  this  counter,  a  value  the  AL  registo'  indicates  whether  or  not  24  hours 
have  passed  since  the  last  reading.  If  the  AL  regista*  contains  a  value  other  than  0, 
24  hours  have  passed.  Hiis  value  does  not  indicate  how  many  24-hour  periods  have 
ehqised  since  the  last  reading. 

If  the  conversion  of  time  values  into  clock  time  is  too  complicated,  function  2CH 
of  DOS  interrupt  21H  can  be  used.  This  function  simply  reads  and  converts  the 
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current  time  using  function  0  of  interrupt  lAH  (see  Chapter  18  of  this  book  for 
more  information  about  function  2CH  of  DOS  interrupt  1  AH). 

Function  01 H:  Set  clock 

Function  number  OlH  sets  the  current  clock  time.  You  can  call  this  function  by 
loading  the  number  1  into  the  AH  register,  the  most  significant  16  bits  of  the 
counts  into  the  CX  register  and  the  least  significant  16  bits  into  the  DX  regist^. 
These  two  registers  combine  to  form  a  32-bit  time  value.  If  the  conversion  of  the 
current  time  into  a  timer  value  is  too  complicated,  function  2DH  of  DOS  int^rupt 
21H  can  be  used  instead  (see  Chapter  18  of  this  book  for  mcH’e  information  about 
function  2DH  of  DOS  interrupt  21H). 

The  next  six  functions  are  available  only  on  the  AT.  If  you  attempt  to  call  these 
functions  on  a  PC  or  an  XT,  nothing  will  happ^  (use  the  model  identification 
program  described  in  Section  7.3  to  check  for  AT  hardware). 

All  six  functions  use  BCD  format  for  time  and  date  indications.  In  this  format, 
two  characters  are  coded  p^  byte,  where  the  higher  number  is  coded  in  the  higher 
nibble  and  the  lower  number  in  the  lower  nibble.  All  six  functions  use  the  carry 
flag  following  a  return  from  the  function  call.  If  the  carry  flag  is  set,  this  indicates 
that  the  realtime  clock  is  malfunctioning  (e.g.,  dead  battery).  The  called  function 
could  not  be  executed  properly. 

Function  02H:  Get  current  time 

Function  02H  reads  the  realtime  clock  time.  You  can  call  the  function  by  loading 
the  function  number  (2)  into  the  AH  register.  The  current  time  is  returned  with  the 
hour  in  the  CH  register,  minutes  in  the  CL  register  and  the  seconds  in  the  DH 
register. 

Function  OSH:  Set  current  time 

Function  03H  sets  the  time  on  the  realtime  clock.  You  can  call  the  function  by 
loading  the  function  number  (3)  into  the  AH  register,  the  hour  into  the  CH 
register,  minutes  into  the  CL  register  and  seconds  into  the  DH  register.  The  DL 
register  indicates  whether  the  ’’daylight  savings  time”  option  is  desired.  A  1  in  the 
DL  register  selects  daylight  savings  time,  while  0  maintains  standard  time. 

Function  04H:  Get  current  date 

Functions  4  and  S  read  and  set  the  date  stored  in  the  realtime  clock.  Both  functions 
use  the  century,  the  year,  the  month  and  the  day  as  arguments.  The  day  of  the  week 
(also  administered  by  the  realtime  clock)  does  not  apply  to  these  functions.  If  you 
want  to  read  the  day  of  the  week,  direct  access  must  te  made  to  the  realtime  clock 
(see  Chapter  10  for  instructions  on  direct  access). 
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Function  04H  gets  the  current  date  from  the  realtime  clock.  You  can  call  this 
function  by  loading  the  function  number  (4)  into  the  AH  register.  The  CH  register 
contains  the  first  two  numbers  of  the  year  (the  century).  The  CL  register  contains 
the  last  two  numbers  of  the  year  (e.g.,  88).  The  month  is  returned  in  the  DH 
register,  and  the  day  of  the  month  in  the  DL  registo:. 

Function  OSH:  Set  current  date 

Function  OSH  sets  the  current  date  in  the  realtime  clock.  You  can  call  this  function 
by  loading  the  function  number  (5)  into  the  AH  register,  either  19  or  20  into  the 
CH  register,  the  last  two  numbers  of  the  year  into  the  CL  register  (e.g.,  89 
decimal),  the  month  into  the  DH  register,  and  the  day  of  the  month  into  the  DL 
register. 

Function  06H:  Set  alarm  time 

Function  06H  allows  the  user  to  set  an  alarm.  Since  only  the  hour,  minute  and 
second  can  be  indicated,  the  alarm  time  applies  only  to  the  current  day.  When  the 
clock  reaches  the  alarm  time,  the  realtime  clock  calls  a  BIOS  routine  which  in  turn 
calls  interrupt  4  AH.  A  user  routine  can  be  installed  under  this  interrupt  to  simulate 
the  sound  of  an  alarm  clock  (you  can  program  the  routine  to  make  other  sounds). 
During  the  system  initialization  interrupt  4AH  moves  to  a  routine  which  contains 
only  the  IRET  assembly  language  instruction.  The  IRET  instruction  forces  the 
CPU  to  terminate  the  interrupt  so  that  arriving  at  alarm  time  doesn't  result  in  any 
action  visible  to  the  user.  You  can  call  this  function  by  loading  the  function 
number  (6)  into  the  AH  register,  the  alarm  hour  into  the  CH  register,  the  alarm 
minute  into  the  CL  register  and  the  alarm  second  into  the  DH  register. 

Function  07H:  Reset  alarm  time 

Only  one  alarm  time  can  be  set.  If  this  function  is  called  while  another  alarm  time 
is  set,  or  has  not  yet  been  reached,  the  carry  flag  is  set  after  the  function  call.  A 
new  alarm  time  doesn't  replace  the  old  alarm  time;  the  old  time  must  be  deleted 
first.  You  can  call  this  function  by  loading  the  function  number  (7)  into  the  AH 
register;  no  other  parameters  are  required.  This  call  clears  the  last  alarm  time  so 
that  a  new  alarm  time  can  be  programmed. 
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7.14  BIOS  Variables 

The  preceding  sections  described  different  BIOS  interrupts  and  their  functions. 
These  functions  require  a  segment  of  memory  fm  storing  variables  and  data.  For 
this  reason,  the  BIOS  reserves  the  area  of  memory  betwera  addresses  0040:000  and 
0050:0000  for  storing  internal  variables.  The  contents  of  most  of  these  variables 
can  be  read  using  some  BIOS  functions,  or  by  using  direct  access.  Sometimes 
direct  access  is  the  easiest  method  of  the  two,  but  it  increases  the  odds  of  a 
program  not  executing  properly  on  certain  PCs.  Since  the  BIOS  can  vary  from  PC 
to  PC,  diffoent  BIOS  versions  may  use  individual  memory  locations  within  this 
area  in  different  ways.  When  wcvking  with  "standard  issue"  PCs  and  compatibles 
(e.g.,  IBM,  Tandon,  etc.),  you  can  assume  that  the  memory  assignment  provided 
hoe  remains  constant  between  machines. 

The  following  list  describes  the  individual  variables,  their  purposes  and  addresses. 
The  address  indicated  is  the  offset  address  of  segment  address  0040H.  For  example, 
a  variable  with  the  offset  address  lOH  has  the  address  (XMftOOlO  or  lOH. 

OOH— 07H 

During  the  booting  process,  a  BIOS  routine  determines  the  configuration  of  its 
PC.  It  determines,  among  other  things,  the  number  of  installed  serial  (RS-232) 
interfaces.  These  intoface  numbers  are  stmed  as  four  words  in  memory  locations 
0040:0000  to  0040:0007.  Each  one  of  these  words  represents  one  of  the  four  cards 
that  can  be  installed  for  asynchronous  data  transmission.  First  the  low  byte  is 
stored,  followed  by  the  high  byte.  Since  few  PCs  have  four  soial  cards  at  their 
disposal,  the  words  which  represent  a  missing  card  contain  the  value  0. 

OSH— OFH 

During  the  booting  process,  a  BIOS  routine  determines  the  conHguration  of  its 
PC.  It  detmnines,  among  other  things,  the  number  of  installed  parallel  int^aces. 
These  card  numbo's  are  stored  as  four  words  in  memory  locations  0040:0008  to 
0O4O:O0OF.  Each  one  of  these  words  stands  for  one  of  Ae  four  cards  that  can  be 
installed  for  parallel  data  transmission.  First  the  low  byte  is  stored,  followed  by 
the  high  byte.  Since  few  PCs  have  four  parallel  cards  at  their  disposal,  the  words 
which  rq)resent  a  missing  card  contain  the  value  0. 

10H— 11H 

This  word  represents  the  hardware  configuration  of  the  PC  as  called  through  BIOS 
interrupt  IIH.  Similar  to  the  above  two  words,  this  configuration  is  determined 
during  the  booting  process.  The  purposes  of  individual  bits  of  this  word  are 
standardized  for  the  PC  and  the  XT,  but  can  dififo’  in  some  odio^  computes. 
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12H 


This  byte  provides  storage  for  uiformation  gathered  during  the  system  self-test, 
execut^  during  the  booting  process  and  after  a  warm  start  BIOS  routines  also  use 
this  byte  for  recognizing  active  keys.  It  has  no  practical  use  for  the  programmer. 

13H— 14H 

This  word  indicates  the  RAM  capacity  of  the  system  in  kilobytes.  This 
information  is  also  gathered  during  the  bwting  {vocess,  and  can  be  read  using 
BIOS  int»rupt  12H. 

15H— 16H 

These  two  bytes  test  the  hardware  during  the  booting  process.  They  have  no  further 
use  after  each  hardware  test 


17H 


This  is  called  the  keyboard  status  byte  because  it  contains  the  status  of  the 
keyboard  and  different  keys.  Function  02H  of  BIOS  keyboard  interrupt  16H  reads 
this  byte.  Accessing  this  byte  allows  the  user  to  toggle  the  <Insert>  or  <Caps 
Lock>  key  on  or  off.  The  upper  four  bits  of  this  byte  may  be  changed  by  the  usct; 
the  lower  four  bits  must  remain  undisturbed. 


IsRIght  SHIFT  key  pressed 


IsLeft  SHIFT  key  pressed 


laCTRL  key  pressed 


la  ALT  key  pressed 


laSCROLL  LOCK  on 


laNUM  LOCK  on 


laCAPS  LOCK  on 


lalNSERT  on 


Keyboard  status  byte 


18H 


This  byte  is  similar  to  byte  17H  above,  with  the  diffoence  that  this  byte  indicates 
the  active  status  of  the  <SysReq>  and  <Break>  keys. 
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1=CTRL  key  pressed 


1=ALT  key  pressed 


IsSysReq  key  pressed 
(AT  &  some  XT) 


isPause  mode  active 


1= BREAK  key  pressed 


IsNUM  key  pressed 


isCAPS  pressed 


isINSERT  pressed 


Extended  keyboard  status  byte 


19H 


This  byte  cuirently  serves  no  purpose;  it  will  be  used  for  status  in  a  proposed 
extended  keyboard  once  that  keyboard  ^)pears  on  the  market 

1AH-1BH 

This  word  contains  the  address  of  the  next  character  to  be  read  in  the  keyboard 
buffo  (see  also  lEH— SDH  below). 

1CH— 1DH 

This  word  contains  the  address  of  the  last  character  in  the  keyboard  buffer  (see  also 
lEH— SDH  below). 

1  EH— SDH 

This  area  of  memory  contains  the  actual  keyboard  buffer.  Since  every  character 
stored  in  the  keyboard  buffo  requires  2  bytes,  its  S2-byte  ctqtacity  space  fo  a 
maximum  of  16  characters.  For  a  normal  ASCII  character,  the  buffa  stores  the 
ASCII  code  and  then  the  character's  scan  code.  The  scan  code  is  the  number  of  the 
activated  key  which  generated  the  ASCII  character.  If  the  character  in  the  keyboard 
buffer  uses  an  extended  code  (e.g.,  a  cursor  key),  then  the  first  byte  contains  the 
value  0  and  the  second  byte  ctmtains  the  extended  key  code. 

The  computer  constantly  reads  charactoa  from  the  keyboard  buffo.  If  the  buffer  is 
not  full,  charact^  can  be  added.  The  address  of  the  next  characto*  to  be  read  firom 
the  keyboard  buffo  is  stored  in  the  word  at  memory  locatitm  0040:001 AH.  When  a 
character  is  read,  the  character  moves  by  2  bytes  toward  the  end  of  the  buffer  in 
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memory.  When  a  characta  was  read  from  the  last  memory  location  of  the  buffer, 
this  pointer  resets  to  the  beginning  of  the  buffo*. 

The  same  is  true  of  the  pointo*  in  memory  location  0040;001C,  which  indicates 
the  end  of  the  keyboard  buffer.  If  you  add  a  new  character,  it  is  stored  in  the 
keyboard  buffer  at  the  location  indicated  by  this  pointer.  Then  the  pointo*  is 
incremented  by  2  to  move  toward  the  end  of  the  buffer.  If  a  new  character  is  stored 
at  the  last  memory  location  of  the  buffer,  this  pointer  resets  to  the  beginning  of 
the  buffo. 

The  relationship  between  the  start  and  end  pointers  tells  something  about  the 
buffer's  status.  Two  conditions  are  of  special  interest.  The  first  is  the  condition 
when  both  pointos  contain  the  same  address  (no  characters  are  currently  available 
in  the  keyboard  buffer).  The  other  condition  is  when  a  characto  should  be  appended 
to  the  end  of  the  keyboard  buffo,  but  adding  2  to  the  end  pointer  would  point  it  to 
the  start  pointer.  This  means  that  the  keyboard  buffer  is  full,  i.e.,  no  additional 
charactos  can  be  accqrted. 


Normal  character: 

ASCII 

code  1  Scan 

□ 

Extended  character:  | 

OOH  1 

Code  1 

Keyboard  bt^er  with  start  and  end  pointers 


401 


7.  The  BIOS 


PC  System  Programming 


3EH 

The  lowest  four  bits  corresptNid  to  the  nomb^  of  installed  PC  disk  drives  (you  are 
allowed  a  maximum  of  four  drives).  These  bytes  also  indicate  whether  the 
connected  drives  must  be  calibrated.  This  is  mostly  the  case  after  an  error  occurs 
during  read,  write  or  search  access.  Whoi  an  error  occurs,  the  ctHresponding  bit  in 
this  byte  is  set  to  0. 

3FH 

The  four  Iowa  bits  of  this  byte  indicate  whether  the  current  disk  drive  motor  is  in 
motion.  A  1  in  the  corresponding  bit  indicates  this.  In  addition,  bit  7  is  always  set 
when  write  access  is  in  progress. 

40H 

This  byte  contains  a  numerical  value  which  indicates  the  time  period  until  a  disk 
drive  motor  switches  off.  Since  BIOS  can  only  access  one  disk  drive  at  a  time,  this 
value  refers  to  the  drive  last  accessed.  Following  access  to  this  drive,  BIOS  places 
the  value  37  into  this  register.  During  every  timer  interrupt  (which  occurs  about 
18.2  times  per  second),  the  value  in  this  byte  is  decrement^  by  1.  When  it  finally 
reaches  0,  Ae  disk  motor  is  turned  off.  This  takes  place  after  about  two  seconds. 

41  H 

This  byte  contains  the  status  of  the  last  disk  access.  When  the  byte  contains  the 
value  0,  the  last  disk  operation  was  performed  in  an  orderiy  manner.  Anotha  value 
signals  that  an  erra  code  was  transmitted  by  the  disk  controller. 

42H— 48H 

These  seven  bytes  indicate  the  status  of  the  NEC  disk  controller.  They  also 
indicate  hard  disk  controller  status  on  hard  disk  systems. 

49H 

This  byte  contains  the  current  display  mode  as  reported  by  the  BIOS.  This  is  the 
same  value  indicated  when  the  user  activates  a  display  mode  through  function  0  of 
the  BIOS  video  interrupt  lOH. 

4AH 


This  word  contains  the  number  of  text  columns  per  display  line  in  the  current 
display  mode. 
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4CH 

This  word  contains  the  number  of  bytes  required  for  the  display  of  a  screen  page  in 
the  current  display  mode,  as  reported  by  the  BIOS.  In  the  80x25-character  text 
mode,  this  is  4,000  bytes. 

4EH— 4FH 

This  word  contains  the  address  of  the  current  screen  page  now  on  the  monitor, 
relative  to  the  beginning  of  video  card  RAM.  The  video  RAM  of  the  color  card 
starts  at  B800:0000  for  the  first  screen  page,  and  at  B800:1000  for  the  second 
screen  page  in  80x25-character  text  mode.  This  variable  usually  contains  the  value 
lOOOH. 

50H— 5FH 

These  16  bytes  contain  the  current  cursor  position  fw  each  screen  page.  BIOS  can 
control  a  maximum  of  8  screen  pages.  BIOS  reserves  two  bytes  for  each  screen 
page.  The  low  byte  indicates  the  screen  column,  which  can  have  values  ranging 
from  0  to  39  (in  40-column  mode)  ot  from  0  to  79  (in  80-column  mode).  The  high 
byte  indicates  the  screen  line,  which  can  have  values  ranging  from  0  to  24.  If  you 
change  the  values  in  this  table,  the  immediate  position  of  the  blinking  cursor 
remains  unchanged,  but  the  change  will  become  noticeable  the  next  time  you  enter 
characters  into  the  corresponding  display  page. 

You  can  use  these  bytes  for  positioning  the  cursor,  but  we  don't  recommend  this 
method. 

60H 

This  byte  contains  the  starting  line  of  the  blinking  cursor,  which  can  have  values 
ranging  from  0  to  7  (color  graphic  card)  or  from  0  to  14  (monochrome  graphic 
card).  Changing  the  contents  of  this  byte  doesn’t  change  the  cursor’s  appearance, 
since  it  must  first  be  transmitted  by  BIOS  to  the  video  controller. 

61H 

This  byte  contains  the  ending  line  of  the  blinking  cursor,  which  can  have  values 
ranging  from  0  to  7  (color  graphic  card)  or  from  0  to  14  (monochrome  graphic 
card).  Changing  the  contents  of  this  byte  doesn’t  change  the  cursor’s  appearance, 
since  it  must  first  be  transmitted  by  BIOS  to  the  video  controller. 

62H 


This  byte  contains  the  number  of  the  currently  displayed  screen  page. 
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63H— 64H 

This  word  contains  the  video  card  port.  If  a  PC  contains  several  video  cards,  the 
value  stored  will  be  the  address  of  the  currently  active  video  card. 


65H 

The  contents  of  a  video  controller  card’s  mode  selector  dictates  the  current  display 
mode.  The  current  value  is  stored  in  this  memory  location. 

66H 

A  color  card  in  medium-resolution  graphic  mode  can  display  320x200  pixels  in 
four  different  colors.  Three  of  these  colors  originate  from  one  of  the  two  color 
palettes.  This  byte  contains  the  currently  active  color  palette  (either  0  or  1). 

67H— 6BH 

The  early  PC  BIOS  versions  could  use  a  cassette  recorder  for  data  storage.  Those 
early  versions  of  BIOS  used  these  five  bytes  for  cassette  access  when  storing  data. 
XT  and  AT  models,  which  do  not  have  this  interface,  use  these  memory  locations 
in  connection  with  RAM  expansion. 

6CH— 6FH 

These  four  bytes  act  as  a  32-bit  counter  for  both  BIOS  and  DOS.  The  counter  is 
incremented  by  1  on  each  of  the  18.2  timer  interrupts  per  second.  This  permits 
time  measurement  and  time  display.  The  value  of  this  counter  can  be  read  and  set 
with  BIOS  interrupt  lAH.  If  24  hours  have  elapsed,  it  resets  to  0  and  counts  up 
from  there. 

70H 

This  byte  contains  a  0  when  the  timer  routine  is  between  0  and  24  hours.  Byte 
70H  changes  to  1  when  the  time  counter  routine  exceeds  its  24-hour  limit.  For 
every  subsequent  24-hour  count,  this  byte  remains  at  1. 

If  the  BIOS  timer  interrupt  1  AH  is  used  to  set  the  time,  this  byte  resets  to  0. 

71H 

This  byte  indicates  whether  or  not  a  keyboard  interrupt  occurs  after  the  user  presses 
<Ctrl><C>  or  <Ctrl><Break>.  If  bit  7  of  this  byte  contains  the  value  1,  a 
keyboard  interrupt  has  occurred. 
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72H— 73H 

During  the  booting  piocess,  a  reset  command  is  sent  to  the  keyboard  Controller. 
For  the  duration  of  this  reset,  the  word  at  this  location  assumes  the  value  1234H. 

XT  BIOS  variables 

The  hardware  configurations  of  the  XT  permit  the  introduction  of  additional 
variables.  The  following  is  a  list  of  BIOS  variables  found  in  the  XT  and  AT. 

74H— 77H 

These  four  bytes  are  used  only  by  hard  disk  systems  for  hard  disk  control. 

78H— 7BH 

Each  of  these  four  bytes  returns  the  status  of  one  of  the  four  prints  ports. 

7CH— 7FH 

Each  of  these  four  bytes  returns  the  status  of  one  of  the  four  asynchronous 
communication  (RS-232)  ports. 

80H— 81H 

This  word  contains  the  beginning  of  the  keyboard  buffer  as  the  offset  address  to  the 
segment  address  0040.  Since  the  keyboard  buffer  normally  starts  at  address 
0040:001E,  this  memory  location  usually  contains  the  value  lEH. 

82H— 83H 

This  word  contains  the  end  of  the  keyboard  buffer  as  the  offset  address  to  the 
segment  address  0040.  Since  the  keyboard  buffer  normally  ends  at  address 
0040:003E,  this  memory  location  usually  contains  the  value  3EH. 

AT  BIOS  variables 

The  advanced  features  of  the  AT  require  even  more  BIOS  variables.  Here  is  a  list  of 
the  BIOS  variables  found  only  on  AT  models. 


88H 


This  byte  ccnitains  the  last  data  transmission  speed  of  the  disk  drive  or  hard  disk. 
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8CH— 96H 

This  mernoy  range  contains  variables  necessary  during  diskAiard  disk  access. 


97H 


This  byte  reserves  a  keyboard  flag  which  shows  the  status  of  the  AT  keyboard's 
LED  (Ught-emitting  dio^). 

98H— AOH 

This  memory  range  accepts  variables  from  the  battoy-powoed  realtime  clock. 

All  members  of  the  PC  family  (PC,  XT  and  AT)  have  a  variable  in  memory 
location  0050:0000.  This  variable  works  in  conjunction  with  the  hardcopy  routine 
(interrupt  S)  to  prevent  printer  output  during  the  printing  of  anoth^  hardcopy.  The 
hardcopy  routine  tests  for  whedier  this  flag  has  a  value  of  0.  If  so,  and  no  hardcopy 
is  being  printed,  the  flag  changes  to  1.  The  BIOS  can  check  this  variable  to  see 
whether  a  printout  is  in  process.  After  a  successful  printout,  this  flag  resets  to  0  to 
allow  additional  printing.  If  an  error  was  detected  during  printer  access,  this  flag  is 
set  to  the  value  2SS  and  the  printing  procedure  aborts. 
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Since  its  birth,  DOS  has  been  criticized  for  its  inability  to  handle  multitasking 
(running  more  than  one  program  at  a  time).  Even  though  OS/2  is  capable  of 
multitasking,  it  runs  only  on  ATs  or  80386-based  computers.  But  TSR  (Terminate 
and  Stay  Resident)  programs  can  bring  some  of  the  advantages  of  multitasking 
into  the  world  of  DOS  machines.  This  type  of  program  moves  into  the 
"background"  once  it  is  started,  and  becomes  active  when  the  user  presses  a 
particular  key  combination.  The  SideKick®  program  produced  by  Borland 
International  made  TSR  programs  very  popular. 

Running  a  TSR  program  isn't  multitasking  in  the  true  sense  of  the  word,  since 
only  one  program  is  actually  running  at  any  given  time.  However,  with  the  touch 
of  a  key,  the  user  can  immediately  access  such  useful  tools  as  a  calculator, 
calendar,  or  note  pad.  In  addition  to  these  applications,  macro  genoators,  screen 
layout  utilities  and  text  editors  can  also  be  found  in  TSR  form. 

Many  TSR  programs  can  even  interact  with  the  programs  that  they  interrupt,  and 
transfer  data  between  the  TSR  and  the  interrupt^  program.  One  example  of  this 
would  be  a  TSR  appointment  book  that  inso'ts  a  page  from  its  calendar  in  a  file 
loaded  into  a  currently  miming  word  processor. 

Although  many  different  applications  can  be  implemented  with  TSR  programs, 
TSR  programs  have  two  things  in  common: 

•  all  use  the  same  basic  method  of  operation 

•  all  are  built  on  similar  programming  concepts 

This  ch^ter  examines  these  two  items,  and  demonstrates  simple  implementations 
of  TSR  programs. 
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Before  we  begin,  we  should  point  out  that  this  involves  very  complex 
programming.  Comprehending  this  material  requires  a  certain  level  of 
understanding  about  how  things  work  within  the  system.  This  is  especially  true  of 
TSR  programs,  since  by  their  very  definition  they  all  but  ignore  the  single-task 
nature  of  DOS,  in  which  one  program  has  access  to  all  of  the  system  resources 
(RAM,  screen,  disk,  etc.).  A  TSR  program  must  contend  with  many  other 
elements  of  the  system  such  as  the  BIOS,  DOS,  the  intorupted  program,  and  even 
other  TSR  programs.  Managing  this  is  a  difficult  but  rewarding  task,  and  can  only 
be  realized  in  assembly  language.  Of  the  available  PC  languages,  only  assembly 
language  offers  the  ability  to  work  at  the  lowest  system  level,  the  interrupt  level. 
But  although  it  has  this  capability,  assembly  language  is  as  flexible  as  high  level 
languages  for  writing  TSR  applications  such  as  calculators  or  note  pads.  Because 
of  this  well  list  two  assembly  language  programs  in  this  chapt^  which  will  allow 
you  to  "convert”  Turbo  Pascal,  Turbo  C,  and  Microsoft  C  programs  into  TSR 
programs. 

Activating  TSR  programs 

r 

Let’s  start  by  looking  at  how  a  TSR  program  is  activated.  To  make  our  TSR 
program  come  to  the  foreground  immediately  after  we  press  a  certain  key 
combination  (called  the  hotkey),  we  must  install  some  sort  of  activiation 
mechanism  tied  to  the  keyboard.  We  can  use  interrupts  09H  and  16H,  two  system 
keyboard  calls.  Interrupt  16H  is  the  BIOS  keyboard  interrupt,  which  programs  use 
to  read  characters  and  keyboard  status.  If  we  use  this  interrupt,  then  our  TSR 
program  can  only  be  activated  when  the  main  program  is  using  interrupt  16H  for 
keyboard  input 

It  would  be  better  to  use  interrupt  09H,  which  is  called  by  the  processor  whenever 
a  key  is  pressed  or  released.  We  can  redirect  this  interrupt  to  our  own  routine, 
which  can  check  to  see  if  the  TSR  program  should  be  activated  or  not.  Before  it 
does  this,  the  routine  should  call  the  old  interrupt  09H  handler.  There  are  two 
reasons  for  this.  The  first  has  to  do  with  the  task  of  interrupt  09H,  which  informs 
the  system  that  the  keyboard  needs  the  system’s  attention  in  order  to  transfer 
information  about  a  key  event.  Therefore,  interrupt  09H  normally  points  to  a 
routine  within  the  ROM  BIOS  which  accepts  and  evaluates  information  fiom  the 
keyboard.  Specifically,  it  receives  the  code  from  the  keyboard,  convats  it  to  an 
ASCII  code,  and  then  places  this  code  in  the  BIOS’s  keyboard  buffer.  Since  our 
TSR  program  neither  wants  nor  is  able  to  handle  this  job,  we  must  call  the 
original  routine,  or  keyboard  input  will  be  impossible. 

The  second  reason  has  to  do  with  the  fact  that  it  is  possible  that  other  TSR 
programs  were  installed  before  ours,  which  have  redirected  interrupt  09H  to  their 
own  routines.  Since  our  program  is  in  front  of  these  programs  in  the  interrupt 
handler  chain,  their  interrupt  routines  will  not  be  called  automatically  if  we  do  not 
call  the  old  interrupt  handler.  The  result  would  be  that  we  could  no  longer  activate 
these  TSR  programs.  The  end  result  is  that  when  a  TSR  program  is  called  via  a 
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redirected  intorupt  routine,  it  should  always  call  the  dd  intorupt  handlo'  before  or 
after  its  own  intorupt  processing. 

The  call  must  not  be  made  with  the  INT  assembly  language  instruction,  since  this 
would  just  recall  our  own  intorupt  handler.  This  would  lead  to  an  infinite  loop  in 
most  cases,  a  stack  ovoflow  and  an  evoitual  system  crash.  To  avoid  this  we  must 
save  the  address  of  the  old  interrupt  handlo*  when  the  TSR  program  is  installed. 
We  can  then  call  the  old  interrupt  handlo'  with  this  sttHed  address  with  the  help  of 
a  FAR  CALL  instructitm.  To  simulate  calling  this  handler  through  the  INT 
instruction,  we  must  first  place  the  contents  of  the  flag  register  on  the  stack  with 
the  PUSHF  instruction  befise  the  CALL. 


Last  installed 
TSR  program 


Other  Installed 
TSR  program 


First  installed 
TSR  program 


Original 

handler  for  interrupt 
09 {h)  in  ROM-BIOS 


Reading  keys  for  TSR  programs  using  interrupt  09H 

After  the  return  from  the  interrupt  handler,  we  can  check  to  see  if  the  hotkey  was 
pressed  to  activate  the  TSR.  The  BIOS  keyboard  flag  at  address  17H  in  the  BIOS 
variable  segmoit  (segment  address  0040H)  indicates  the  status  of  the  following 
keys: 


•  right  <Shift>  key 

•  left  <Shift>  key 

•  <Ctrl>  key 

•  <Alt>  key 

•  <Num>  key 

•  <Scroll  Lock>  key 
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•  <CapsLock>  key 

•  <SysReq>  key  (AT  keyboard  only) 

If  the  appropriate  keys  are  pressed,  the  user  is  trying  to  activate  the  TSR  program. 
We  can  only  do  this  if  certain  conditions  are  met,  all  of  which  come  down  to  the 
fact  that  the  DOS  is  not  re-entrant. 


DOS 

Since  the  TSR  program  can  be  activated  from  the  keyboard  at  any  time,  regardless 
of  the  other  processes  in  the  system,  it  could  conceivably  interrupt  a  call  to  a  DOS 
function.  This  may  not  lead  to  problems  as  long  as  the  TSR  program  returns  to 
the  interrupted  DOS  function  properly.  The  problem  occurs  when  the  TSR  itself 
tries  to  call  DOS  functions,  which  is  hard  to  avoid  when  programming  in  a  high 
level  language.  Here  we  see  the  problem  of  re-entry.  This  refers  to  the  ability  of  a 
system  to  allow  multiple  programs  to  call  and  execute  its  code  at  the  same  time. 
DOS  is  not  re-entrant,  however,  since  it  is  a  single-task  system  and  assumes  that 
DOS  functions  will  be  called  in  sequence,  and  not  in  parallel. 

Calling  a  DOS  function  from  within  a  TSR  program  while  another  function  is 
executing  leads  to  problems  because  the  processor  register  SS:SP  is  loaded  with 
the  address  of  one  of  three  DOS  stacks  when  interrupt  21H  is  called.  Which  of  the 
three  stacks  is  used  depends  on  the  function  group  to  which  the  DOS  function 
belongs,  and  cannot  be  determined  by  the  caller.  While  the  DOS  function  is  being 
executed,  it  places  temporary  data  on  this  stack  as  well  as  the  return  address  to  the 
calling  program.  If  the  execution  of  the  function  is  then  interrupted  by  the 
activation  of  a  TSR  program  which  then  calls  a  DOS  function,  DOS  will  again 
load  register  pair  SS:SP  with  the  starting  address  of  an  internal  stack.  If  it  is  the 
same  stack  that  the  interrupt  function  was  using,  each  access  to  the  stack  will 
destroy  the  data  of  the  other  function  call.  The  DOS  function  called  by  the  TSR 
program  will  be  executed  properly,  but  the  problem  will  occur  when  the  TSR 
program  ends  and  control  returns  to  the  interrupted  DOS  function.  Since  the 
contents  of  the  stack  have  been  changed  in  the  meantime  by  other  DOS  calls,  the 
DOS  function  will  probably  crash  the  system. 

Bypassing  re-entry 

There  are  two  ways  to  get  around  these  re-entry  problems:  Avoid  calling  DOS 
functions,  or  allow  the  TSR  program  to  be  activated  only  if  no  DOS  functions  are 
being  executed.  We  have  already  ruled  out  the  first  option,  so  we  must  use  the 
second.  DOS  helps  us  here  by  providing  the  MDOS  flag,  which  is  normally  only 
used  inside  DOS  but  which  is  very  useful  to  us  as  well.  It  is  a  counter  which 
counts  the  nesting  depth  of  DOS  calls.  If  it  contains  the  value  0,  no  DOS 
functions  are  currently  being  executed.  The  value  1  indicates  the  current  execution 
of  a  DOS  function.  Under  certain  conditions  this  counter  can  also  contain  larger 
values,  such  as  when  one  DOS  function  calls  another  DOS  function,  which  is 
allowed  only  in  special  cases. 
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Since  there  is  no  DOS  function  to  read  the  value  of  this  flag,  we  have  to  read  the 
contents  directly  from  memory.  The  address  does  not  change  after  the  system  is 
booted,  so  we  can  get  the  address  when  the  TSR  is  installed  and  save  it  in  a 
variable.  DOS  function  34H  returns  the  address  of  the  INDOS  flag  in  register  pair 
ES:BX. 

This  flag  is  read  in  the  interrupt  handler  for  interrupt  09H  since  it  checks  to  see  if 
the  hotkey  was  pressed,  and  allows  the  TSR  program  to  be  activated  only  if  the 
INDOS  flag  contains  the  value  0.  This  is  not  the  whole  solution  to  the  problem, 
however.  It  coordinates  the  activation  of  the  TSR  program  with  DOS  function 
calls  of  the  transient  program  being  executed  in  the  foreground,  but  it  does  not 
allow  the  TSR  program  to  be  called  from  the  DOS  user  interface.  Since  the  DOS 
command  processor  (COMMAND.COM)  uses  some  DOS  functions  for  printing 
the  prompt  and  accepting  input  from  the  user,  the  INDOS  flag  always  contains  the 
value  1.  In  this  special  case  we  can  interrupt  the  executing  DOS  function,  but  we 
must  make  sure  that  the  INDOS  flag  contains  the  value  1,  because  a  DOS  function 
can  be  called  from  transient  program  or  from  the  DOS  command  processor. 

There  is  a  solution  for  this  problem  too.  It  involves  the  fact  that  the  DOS  is  in  a 
kind  of  a  wait  state  when  it  is  waiting  for  input  from  the  user  in  the  command 
processor.  To  avoid  wasting  any  valuable  processor  time,  it  periodically  calls 
interrupt  28H,  which  is  responsible  for  short  term  activation  of  background 
processes  like  the  print  spooler  (DOS  PRINT  command)  and  other  tasks.  If  this 
interrupt  is  called,  it  is  relatively  safe  to  interrupt  DOS  and  call  the  TSR  program. 

To  use  this  procedure,  a  new  handler  for  interrupt  28H  is  installed  when  the  TSR 
program  is  installed.  It  first  calls  the  old  handler  for  this  interrupt  and  then  checks 
to  see  if  the  hotkey  has  been  pressed.  If  this  has  occurred,  the  TSR  program  can  be 
activated,  even  if  the  INDOS  flag  is  not  0. 

One  more  restriction  must  still  be  added — ^we  cannot  allow  the  TSR  program  to  be 
activated,  even  using  the  handler  for  interrupt  09H,  if  time-critical  actions  are 
being  performed  in  the  system. 

Time-critical  actions 

These  are  actions  which,  for  various  reasons,  cannot  be  interrupted  because  they 
must  complete  execution  in  a  relatively  short  time.  In  the  PC  this  includes 
accesses  to  the  floppy  and  hard  disk,  which  at  the  lowest  levels  are  controlled  by 
BIOS  interrupt  13H.  If  an  access  to  these  devices  is  not  completed  by  a  certain 
time  it  can  cause  serious  system  disruptions.  A  dramatic  example  is  if  the  TSR 
program  performs  an  access  to  these  devices  before  another  access,  which  is 
initiated  by  the  interrupted  program,  has  finished.  Even  if  this  doesn’t  crash  the 
system,  it  will  lead  to  loss  of  data. 

We  can  avoid  this  by  installing  a  new  interrupt  handler  for  BIOS  interrupt  13H. 
When  this  handler  is  called,  it  sets  an  internal  flag  which  shows  that  the  BIOS  disk 
interrupt  is  currently  active.  Then  it  calls  the  old  interrupt  handler  which  performs 
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the  access  to  the  floppy  or  hard  disk.  When  it  returns  to  the  TSR  handler,  the  flag 
is  cleared,  signalling  the  end  of  BIOS  disk  activity. 

To  prevent  this  interrupt  handler  from  being  interrupted,  the  other  TSR  interrupt 
handlers  all  monitor  this  flag  and  will  activate  the  TSR  program  only  if  the  flag 
indicates  that  the  BIOS  disk  interrupt  is  not  active. 

Recursion 

One  last  condition  placed  on  the  activation  of  a  TSR  program  is  that  recursive 
activations  are  prohibited.  Since  the  hotkey  can  still  be  pressed  after  the  TSR 
program  has  been  activated,  we  must  prevent  the  TSR  program  from  being 
reactivated  before  it  is  flnished.  We  can  simply  add  another  flag  which  is  checked 
before  the  TSR  is  activated.  The  TSR  program  sets  this  flag  when  it  begins  and 
clears  it  again  just  before  it  ends.  If  an  interrupt  handler  determines  that  this  flag  is 
set,  it  will  simply  ignore  the  hotkey. 

Once  all  of  these  conditions  have  been  satisfied,  we  can  activate  the  TSR  program. 
Context  switch 

The  process  of  activating  a  TSR  program  is  called  a  context  switch.  The  program 
context  or  environment  is  all  the  information  needed  for  operating  the  program. 
This  includes  such  things  as  the  contents  of  the  processor  registers,  important 
operating  system  information,  and  the  memory  occupied  by  the  program.  We  don't 
have  to  worry  about  the  program  memory  in  our  context  switch,  however,  since 
our  TSR  program  is  already  marked  as  resident,  meaning  that  the  operating  system 
will  not  give  the  memory  it  occupies  to  other  programs. 

The  processor  registers,  especially  the  segment  registers,  must  be  loaded  with  the 
values  which  the  TSR  program  expects.  These  are  saved  in  internal  variables  when 
the  TSR  program  is  installed.  Since  the  contents  of  these  and  other  registers  will 
be  changed  by  the  TSR  program,  the  contents  of  the  registers  must  be  saved 
because  they  belong  to  the  context  of  the  interrupted  program  and  must  be  restored 
when  it  is  resumed. 

The  same  applies  for  context  dependent  operating  system  information,  which  for 
DOS  includes  just  the  PSP  (Program  Segment  Prefix)  of  the  program  and  the 
DTA  (Disk  Transfer  Area).  The  addresses  of  both  structures  must  be  determined  and 
saved  when  the  TSR  program  is  installed,  so  that  they  can  be  reset  when  context  is 
changed  to  the  TSR  program.  Also,  we  must  not  forget  to  save  the  addresses  of  the 
PSP  and  DTA  of  the  interrupted  program  before  the  context  change  to  the  TSR 
program.  There  are  DOS  functions  for  setting  and  reading  the  address  of  the  DTA 
(DOS  functions  lAH  and  2FH),  but  there  are  no  corresponding  documented 
functions  for  the  PSP.  DOS  Version  3.0  includes  function  62H,  which  returns  the 
address  of  the  current  PSP,  but  has  no  function  for  setting  the  address. 
Undocumented  functions  for  doing  both  exist  in  DOS  2.0:  function  50H  (set  PSP 
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address)  and  SIH  (get  PSP  address).  Both  of  these  are  used  in  our  TSR 
demonstration  program. 

One  final  ta^  is  required  of  the  TSR  code.  When  the  TSR  program  is  activated 
using  intonipt  28H,  an  active  DOS  function  is  interrupted — one  whose  stack  must 
not  be  disturb.  Genaally  we  should  take  the  t(q>  64  words  from  the  currait  stack 
and  place  them  on  the  stack  of  the  TSR  program.  This  completes  the  context 
change  to  the  TSR  program,  which  means  that  the  TSR  program  can  now  be 
started. 

At  the  moment,  the  TSR  program  can  be  viewed  as  a  completely  normal  program 
which  can  call  arbitrary  DOS  and  BIOS  functions.  The  only  competitcH'  left  in  the 
system  is  the  foreground  {Hogram.  The  TSR  must  ensure  that  it  leaves  both  the 
foreground  program  and  its  screen  undisturbed. 

Saving  the  screen  context 

The  tasks  were  exclusively  handled  in  assembly  language.  However,  the  C  or 
Pascal  program  comprising  the  TSR  program  itself  can  save  the  screoi  context. 
This  screen  context  includes  the  current  video  mode,  the  cursor  position  and  the 
screen's  contents.  The  contents  of  the  color  regist^s  and  other  registers  on  the 
video  card  must  also  be  saved,  if  any  of  these  values  are  changed  by  the  TSR 
program. 

As  described  in  Section  7.4,  the  video  mode  can  easily  be  detomined  with  function 
OOH  BIOS  video  interrupt  16H.  If  the  screen  is  in  text  mode  (modes  0, 1, 2, 3, 
and  7),  the  TSR  program  must  save  the  first  40(X)  bytes  of  video  RAM.  The  video 
BIOS  can  be  us^  for  this  (see  Section  7.4),  or  you  can  access  the  video  RAM 
directly  (see  Ch^rto^  10). 

Saving  the  video  mode  becomes  very  complicated  if  a  graphics  mode  is  active, 
since  the  video  RAM  for  EGA  and  VGA  cards  can  be  as  large  as  2S6K  in  some 
modes.  If  the  TSR  program  interrupted  a  transient  program,  it  may  not  be  possible 
to  allocate  a  large  enough  buffo'  to  handle  both  programs. 

This  is  why  many  TSR  programs  will  not  activate  themselves  from  within 
graphics  mode,  and  can  only  be  used  in  text  mode.  Since  PCs  mostly  use  text 
mode,  this  doesn't  present  a  big  problem.  GEM®  and  Microsoft  Windows®, 
which  op^te  only  in  grajAics  mode,  are  exceptions.  Since  these  programs  usually 
support  some  mechanism  for  parallel  execution  of  calculators,  note  pads,  etc., 
TSR  programs  can  prove  less  useful  under  these  systems. 

The  assembler  interface 

We  now  have  enough  information  to  understand  the  opmtion  of  the  two  assembly 
language  intofaces.  The  two  programs  are  based  on  the  principles  we  have  outlined 
hoo;  the  diffoences  between  th^  reflect  the  diffraent  syntaxes  of  compiled  C  and 
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Pascal  programs.  We  will  first  concentrate  on  the  common  points  of  the  two 
programs. 

Both  programs  assume  that  the  TSR  program  was  installed  by  the  first  call  from 
the  IX)S  level,  and  will  be  reinstalled  on  each  new  call.  It  is  important  to 
remember  one  general  rule:  a  TSR  program  can  be  reinstalled  only  if  no  other  TSR 
programs  have  been  installed  in  the  meantime.  The  LIFO  (Last  In,  First  Out) 
principle  applies  here,  so  the  only  way  a  TSR  program  can  be  reinstalled  is  if  it 
was  the  last  one  to  be  installed,  and  if  the  corresponding  interrupt  vectors  point  to 
its  interrupt  handlers.  If  another  TSR  program  was  installed  following  it,  the 
interrupt  vectors  point  to  its  handlers. 

To  support  this  mechanism,  the  assembly  language  interface  offers  the  high-level 
program  three  routines  with  which  install  and  later  reinstall  the  TSR  program.  To 
decide  whether  the  program  should  be  installed  or  reinstalled,  the  first  function 
should  be  called  to  see  if  the  TSR  program  is  already  installed.  This  routine  is 
passed  an  identification  string,  which  will  play  an  important  role  later  when  the 
program  is  installed.  The  routine  looks  for  this  ID  string  within  the  handler  for 
interrupt  09H.  If  it  finds  the  string,  the  TSR  program  is  already  installed  and  can 
be  reinstalled. 

If  the  ID  string  is  not  discovered,  the  TSR  program  has  not  been  installed,  or 
another  TSR  program  redirected  the  interrupt  ()9H  vector  in  the  meantime.  The 
TSR  program  can  then  be  installed  with  the  help  of  the  installation  routine.  This 
routine  must  receive  the  ID  string  used  to  detect  whether  the  program  has  already 
been  installed,  the  address  of  the  high  level  routine  which  will  be  called  when  the 
TSR  program  is  activated,  and  the  hotkey  value.  The  hotkey  value  is  the  bit 
pattern  in  the  BIOS  keyboard  flag  which  will  activate  the  TSR  program  and  can  be 
defined  within  the  high  level  language  program  with  the  help  of  predefined 
constants. 

The  initialization  routine  first  saves  the  addresses  of  the  interrupt  handlers  for 
interrupts  09H,  13H  and  28H.  Then  the  data  for  the  context  of  the  high  level 
program  are  read  and  saved  in  variables  within  the  code  segment,  so  that  they  are 
available  for  the  interrupt  handler  and  for  activation  of  the  TSR  program.  In  the 
next  step,  the  new  interrupt  handlers  for  interrupts  09H,  13H,  and  28H  are 
installed.  Finally,  the  number  of  paragraphs  after  the  end  of  the  program  which  are 
to  remain  resident  must  be  calculated.  Here  the  C  and  Pascal  interfaces  differ  from 
each  other.  Information  about  this  calculation  can  be  found  in  the  individual 
descriptions  of  the  interfaces. 

The  actual  installation  is  now  over  and  the  program  is  terminated  as  resident. 
Notice  that  the  installation  routine  does  not  return  to  the  high  level  language 
program,  so  all  initialization  such  as  memory  allocation  or  variable  initialization 
must  be  performed  before  the  call  to  this  routine. 
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If  the  test  function  of  the  assembly  language  module  detomines  that  the  program 
is  already  installed,  it  can  be  reinstalled  with  the  help  of  another  function.  This 
function  is  passed  the  address  of  a  routine  in  the  high  level  language  program 
which  will  perfcHm  a  "deanup"  of  the  program.  This  process  includes  releasing 
allocated  meimxy  and  other  tasks.  If  no  such  routine  is  to  be  called,  the  assembly 
language  routine  must  be  passed  the  value  -1.  Since  the  "cleanup"  function  is  in 
the  TSR  program,  and  not  in  the  program  which  is  performing  the  reinstallation,  a 
context  switch  is  necessary.  Unlike  activation  of  the  TSR  program  and  the 
ctaresponding  interruption  of  the  foreground  program,  this  is  from  the  program 
which  is  doing  the  reinstallation  to  the  already  installed  TSR  program.  The 
reinstallation  returns  the  redirected  interrupt  handlers  to  their  old  routines  and 
releases  die  memory  allocated  by  the  TSR  program. 

In  addition  to  these  three  functions  which  are  called  from  the  high  level  language 
program,  the  assembler  module  contains  some  routines  which  may  not  be  called 
by  high  level  language  programs.  These  include  the  interrupt  handlers  for 
interrupts  0911, 13H,  and  as  well  as  a  routine  which  accomplishes  the  context 
switch  to  mid  from  the  TSR  program. 

The  high  level  language  programs 

The  following  programs  in  C  and  Pascal  demonstrate  the  assembly  language 
routines.  They  first  check  to  see  if  the  program  is  already  installed  or  not.  On  a 
new  installation,  a  TSR  routine  is  installed.  You  can  activate  the  TSR  by  pressing 
both  <Shift>  keys.  It  stores  the  screen  contents,  then  displays  a  message  and  asks 
the  usa*  to  press  a  key.  After  this  is  done,  the  old  screen  contents  are  c<^ied  back 
and  the  execution  of  the  interrupted  program  cratinues. 

On  a  reinstallation,  the  assembly  language  reinstallation  program  calls  a  cleanup 
function  in  the  TSR  program.  It  prints  the  number  of  activations  of  the  TSR 
program,  which  is  set  to  when  the  TSR  program  is  installed  and  incremented 
on  each  activation.  This  makes  it  clear  that  the  cleanup  function  is  actually 
executed  in  the  installed  TSR  program  and  not  in  the  program  which  performs  the 
reinstallation. 

TSR  development 

There  are  some  {Hocedures  you  should  follow  when  developing  TSR  (ffograms, 
that  apply  to  the  special  characteristics  of  these  programs.  First,  the  program 
should  be  developed  as  a  completely  normal  program,  compiled  and  executed  fiom 
the  DOS  user  int^ace,  or  an  interactive  environment.  To  prepare  for  conversion  to 
a  TSR  iHOgram,  you  can  write  an  iiutialization  routine  and  the  actual  TSR  routine 
which  will  be  called  when  the  hodrey  is  pressed.  Unlike  the  TSR  version,  you  can 
call  these  routines  in  the  main  procedure/function  of  the  program,  allowing 
activation  indqiendent  of  any  hotkeys.  You  should  completely  ^velop  and  test  the 
program  in  this  maimw.  Once  it  wcvks  correctly,  you  can  convert  it  to  a  TSR 
program. 
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The 


The  conversion  to  a  TSR  program  is  relatively  simple,  and  involves  linking  in  the 
assembly  language  module  to  the  program  and  calling  the  corresponding  functions. 
You  can  see  how  this  is  done  in  detail  in  the  two  example  programs. 

After  linking  the  assembly  language  routines  and  converting  the  program  to  an 
EXE  file,  it  should  be  started  only  from  DOS.  Do  not  start  it  from  within  an 
interactive  environment  like  Turbo  Pascal  or  Turbo  C. 


implementation 


Since  TSR  programs  should  use  as  little  memory  as  possible,  the  assembly 
language  interface  was  developed  to  be  linked  with  the  smallest  C  memory  model 
(the  small  model).  In  both  Microsoft  and  Turbo  C  compilers,  the  program  code  and 
data  are  placed  in  two  separate  segments,  each  of  which  may  be  no  larger  than 
64K.  The  data  includes  global  and  static  data  as  well  as  the  stack  and  the  heap.  As 
the  following  figures  show.  Turbo  C  and  Microsoft  C  use  different  memory 
organization,  despite  their  similarities.  While  in  Turbo  C  the  stack  is  placed 
behind  the  heap  and  moves  from  the  end  of  the  data  segment  to  the  end  of  the  heap, 
the  stack  is  between  the  global  data  and  the  heap  in  Microsoft  C. 


:SP  ^ 

,  SS,ES*^^ 

Stack  A 

FFFF(h)| 

Heap 

T 

Heap 

SS  SP  — ► 

Stack 

Global  t  static  data 

/ 

Global  t  static  data 

Program  code 

'0000(h>^  DS.SS.ES-^ 

^max  64K 

CS 

Program  code 

PSP 

PSP 

Microsoft  C 


Structure  of  a  small  model  program  (Turbo  C/Microsoft  C) 

If  this  organization  had  no  effect  on  the  assembly  language  interface,  we  would  be 
ready  to  allocate  the  entire  64K  of  the  data  segment  resident  in  memory  in  addition 
to  the  program  code.  Since  this  would  mean  a  significant  waste  of  memory,  and 
TSR  programs  should  use  as  little  memory  as  possible,  the  assembly  language 
should  mark  as  resident  only  the  part  of  the  data  segment  which  is  actually 
required. 

The  size  of  this  memory  area  depends  on  the  size  of  the  data  (or  objects)  which 
will  be  allocated  on  the  heap  by  the  functions  callocQ  and  mallocQ.  You  must 
guess  this  size  and  pass  it  to  the  initialization  routine  so  that  the  end  of  the 
required  memory  in  the  data  segment  can  be  calculated. 

This  mechanism  allows  you  to  use  the  heap  functions  normally  within  the  TSR 
program.  Unfortunately,  this  applies  only  to  the  Turbo  C  compiler.  Microsoft  C 
uses  an  allocation  algorithm  which  assumes  that  all  of  the  memory  to  the  end  of 
the  data  segment  is  available,  so  allocating  heap  storage  should  be  avoided  within  a 
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TSR  program  compiled  with  Microsoft  C.  You  should  allocate  the  buffers  and 
variables  required  when  the  TSR  program  is  initialized  or  place  the  required  objects 
in  global  variables.  The  example  C  program  allocates  the  two  buffers  it  needs  in 
the  mainQ  function  and  then  places  die  addresses  of  the  buffers  in  global  variables. 

There  is  something  else  you  should  be  aware  of  when  using  Turbo  C.  Since  the 
stack  grows  from  the  end  of  the  64K  data  segment  to  the  heap,  it  finds  itself 
outside  the  program  when  parts  of  the  data  segment  are  released  again,  and  this  in 
an  area  of  memory  which  DOS  may  give  to  other  programs.  To  avoid  problems 
with  this,  the  assembly  language  interface  places  the  stack  immediately  aft^  the 
heap,  giving  it  512  bytes  of  space.  This  should  suffice  for  most  applications,  but 
may  lead  to  problems  if  you  use  large  objects  (such  as  arrays)  as  local  variables  or 
pass  them  to  other  functions  via  the  stack.  In  this  case  you  should  enlarge  the 
stack  by  setting  the  constant  TC_STACK  in  the  assembly  language  interface  to  a 
larger  value. 

The  different  treatment  of  the  stack  is  the  reason  that  the  initialization  routine  in 
the  assembly  language  interface  must  be  told  what  compiler  the  TSR  program  will 
be  compiled  with.  In  practice  you  don't  have  to  worry  about  this  since  it  is  handled 
within  the  C  program  with  the  help  of  constants  defined  with  conditional 
preprocessor  statements. 

The  TSR  initialization  routine  TSRJNIT  must  be  called  with  the  following 
parameters  (in  the  specified  order): 

•  Compiler  type  (0  =  Microsoft  C,  1  =  Turbo  C) 

•  Pointer  to  the  C  TSR  function 

•  Hotkey  (mask  for  reading  the  BIOS  keyboard  flag) 

•  Number  of  bytes  to  keep  free  on  the  heap 

•  Pointer  to  an  identification  string 

The  initialization  routine  uses  the  information  about  the  compiler  type  and  the 
number  of  bytes  which  must  be  available  on  the  stack  to  calculate  the  number  of 
paragraphs  which  must  remain  resident  in  memory.  The  C  library  function  SBRK 
is  called  from  the  assembly  language  routine  to  determine  the  offset  address  of  the 
current  end  of  heap.  The  number  of  bytes  which  must  be  reserved  for  the  heap  is 
added  to  this  address.  With  Turbo  C  we  also  add  the  size  of  the  stack,  which  is 
appended  to  the  heap  and  must  also  stay  resident.  The  result  of  this  addition  is  the 
offset  address  of  the  last  byte  in  memory  relative  to  the  start  of  the  data  segment. 

This  address  is  converted  to  paragraphs  by  shifting  it  four  places  to  the  right, 
dividing  it  by  16.  The  result  is  the  number  of  paragraphs  which  must  remain 
resident  in  the  data  segment.  In  addition,  there  are  the  paragraphs  from  the  PSP  and 
the  code  segment.  They  can  be  calculated  by  subtracting  the  segment  address  of  the 
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data  segment  (which  is  also  the  ending  address  of  the  code  segment)  and  the 
segment  address  of  the  PSP.  Since  both  Turbo  C  and  Microsoft  C  store  the 
segment  address  of  the  PSP  in  a  global  variable  called  _PSP,  it  can  be  read  by  the 
assembly  language  routine  and  included  in  the  subtraction.  The  program  is  then 
ended  by  a  call  to  DOS  function  31H,  which  keq>s  the  specified  number  of 
paragng>hs  (passed  in  the  DX  register)  resident  The  program  is  installed. 

If  a  cleanup  {vogram  is  to  be  called  when  the  program  is  reinstalled  with  the 
UNINST  function,  the  UNINST  function  must  be  passed  a  pointer  to  this 
function.  In  C  this  is  done  simply  by  using  the  name  of  the  function  to  be  called 
asaparameto'. 

If  no  such  function  is  to  be  called,  the  argument  -1  must  be  passed.  Since  this  is 
not  a  valid  function  pointer,  it  must  be  preceded  by  the  following  cast  operator: 

(void  (*)(void))  -1 

Thwe  is  a  symbol,  NO_END_FTN,  defined  with  this  expression  in  the  C  program 
which  you  can  use  in  the  call  to  UNINST. 

You  can  get  additional  infcamation  from  the  following  listing.  It  will  make  a  good 
basis  for  developing  your  own  TSR  programs. 

C  listing:  TSRC.C 

/********★*************************************************************/ 


/*  T  S  R  C  */ 

/* - */ 

/*  Description  :  C  module  which  is  turned  into  a  TSR  program  */ 

/*  with  the  help  of  an  assembly  language  routine.  */ 

/* - */ 

/*  Author  ;  MICHAEL  TISCHER  */ 

/*  developed  on  :  08/15/1988  */ 

/*  last  update  :  08/19/1988  */ 

/*  (MICROSOFT  C)  */ 

/*  creation  :  CL  /AS  /c  TSRC.C  */ 

/*  LINK  TSRC  TSRCA;  */ 

/*  call  :  TSRC  */ 

/*  (BORLAND  TURBO  C)  */ 

/*  creation  :  Create  project  file  with  the  following  */ 

/*  contents:  */ 

/*  TSRC  */ 

/*  TSRCA. OBJ  */ 

/*  Before  ccmpiling,  set  Options  menu  /  linker  */ 

/*  option  /  Case  sensitive  link  to  OFF  */ 

/★*★*****•***★**********•*********************************★★★*★**********/ 

/*=*  Include  files 

♦include  <stdlib.h> 

♦include  <dos.h> 

/*==»  Typedefs 

typedef  unsigned  char  BYTE;  /*  build  ourselves  a  byte  */ 

typedef  unsigned  int  WORD; 

typedef  BYTE  BOOL;  /*  like  BOOLEAN  in  Pascal  */ 
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typedef  union  vel  far  *VP;  /*VPisa  FAR  pointer  into  the  VRAM  */ 


#ifndef  MK_FP  /*  was  MK_FP  already  defined?  */ 

♦define  MK_FP(seg,  ofs)  ((void  far  *)  ((unsigned  long)  (seg) «16 | (ofs) ) ) 
iendif 

♦define  VOFS(x,y)  (  80  *  (  y  )  +  (  x  )  ) 

♦define  VPOS(x,y)  (VP)  (  vptr  +  VOFS(  x,  y  )  ) 


/★«*  Structures  and  unions 


struct  velb  {  /*  describes  a  screen  position  as  two  bytes  */ 

BYTE  character,  /*  the  ASCII  code  */ 

attribute;  /*  corresponding  attribute  */ 

}; 

struct  velw  {  /*  describes  a  screen  position  as  one  word  */ 

WOE®  contents;  /*  stores  ASCII  character  and  attribute  */ 

}; 

union  vel  {  /*  describes  a  screen  position  */ 

struct  velb  h; 
struct  velw  x; 

}; 


/*»=  Link  the  functions  from  the  assembly  module  »««»===«--==*«>======«*/ 

extern  int  ls_inst (  char  *  id_strlng  ) ; 
extern  void  uninst(  void  (*fkt) (void)  ); 

extern  int  tsr_init (BOOL  TC,  void  (*fkt) (void) ,  unsigned  hotkey, 
unsigned  heap,  char  *  id_string) ; 


/  *  **»  Const  ants  =*=====*====»=»==»===«===«=====*»»=====«=««»*==»»=»=«==*  / 

♦ifdef  _TURBOC_  /*  are  we  compiling  with  TURBO-C?  */ 

♦define  TC  TRUE  /*  yes  */ 

♦else  /*  we  are  using  Microsoft  C  */ 


♦define  TC  FALSE 
♦endif 


/* —  codes  of  the  individual  control 

keys  for  building  the  hotkey  mask 

*/ 

♦define 

RSHIFT 

1 

/*  right  SHIFT  key  pressed 

*/ 

♦define 

LSHIFT 

2 

/*  left  SHIFT  key  pressed 

*/ 

♦define 

CTRL 

4 

/*  CTRL  key  pressed 

*/ 

♦define 

ALT 

8 

/*  ALT  key  pressed 

*/ 

♦define 

SCRL  AN 

16 

/*  Scroll  Lock  ON 

*/ 

♦define 

NUML  AN 

32 

/*  Num  Lock  ON 

*/ 

♦define 

CAPL  AN 

64 

/*  Caps  Lock  (XI 

*/ 

♦define 

INS  AN 

128 

/*  Insert  ON 

*/ 

♦define 

SCR_L0CK 

4096 

/*  Scroll  Lock  pressed 

*/ 

♦define 

NUM  LOCK 

8192 

/*  Num  Lock  pressed 

*/ 

♦define 

CAP  LOCK 

16384 

/*  Caps  Lock  pressed 

*/ 

♦define 

INSERT 

32768 

/*  INSERT  key  pressed 

*/ 

♦define 

NOF 

0x07 

/*  normal  color 

*/ 

♦define 

INV 

0x70 

/*  inverse  color 

*/ 

♦define 

HNOF 

0x0  f 

/*  bright  normal  color 

*/ 

♦define 

HINV 

OxfO 

/*  bright  inverse  color 

*/ 

♦define 

HEAP_FREE  1024 

/*  leave  IK  space  on  the  heap 

*/ 

♦define 

TRUE/  1 

/*  constants  for  working  with  BOOL 

*/ 

♦define 

FALSE  0 

♦define 

NO_END_FTN  ((void  (*)(vold)) 

-1)  /*  don't  call  an  end  ftn. 

*/ 

AC _ 

-★  / 

char  id_string[] 

-  "MiTi"; 

/*  identification  string 

•  / 

*/ 
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VP  vptr; 

unsigned  atlmes  *  0; 
union  vel  *  scrbuf; 
char  *  blanlc_line; 


/*  pointer  to  the  first  character  in  video  RAM  */ 
/*  number  of  activations  of  the  TSR  program  */ 
/*  pointer  to  the  buffer  with  screen  contents  */ 
/*  pointer  to  a  blank  line  */ 


/★**★*★****★★***  *******************************^^************^^*  ********** 

*  Function  :DISP_INIT  * 

** - ** 

*  Description  :  Determines  the  base  address  of  the  video  RAM.  * 

*  Input  parameters  :  none  * 

*  Return  value  :  none  * 

***********************************************************************/ 


void  disp_lnlt (void) 

( 

union  REGS  regs;  /*  processor  regs  for  the  interrupt  call  */ 

regs.h.ah  =15;  /*  function  number:  determing  video  mode  */ 

int86(0xl0,  &regs,  &regs) ;  /*  call  the  BIOS  video  interrupt  */ 

/*  calculate  base  addr  of  the  video  RAM  according  to  the  video  mode  */ 

vptr  =  (VP)  MK__FP((regs.h.al  ==  7)  ?  OxbOOO  :  OxbSOO,  0); 

} 


/*********************************************************************** 


*  Function  :DISP_PRINT  * 

** - ** 


*  Description 

*  Input  parameters 


*  Return  value 


Output  a  string  to  the  screen. 

-  COLUMN  =  the  output  column 

-  LINE  =  the  output  line 

-  COLOR  =  attribute  for  the  characters 

-  STRING  =  pointer  to  the  string 
none 


***********************************************************************/ 


void  disp_print (BYTE  column,  BYTE  line,  BYTE 
color,  char  *  string) 

{ 

register  VP  Iptr;  /*  running  pointer  for  accessing  the  video  RAM  */ 

Iptr  =  VPOS (column,  line);  /*  set  pointer  to  the  video  RAM  */ 

for  (  ;  *string  ;  ++lptr)  /*  run  through  the  string  */ 

{ 

lptr->h. character  =  *(string++);  /*  write  char  into  the  video  RAM  */ 
lptr->h. attribute  =  color;  /*  set  attribute  for  the  character  */ 

} 

} 


/*********************************************************************** 


*  Function  :SAVE_SCREN  * 

** - ★* 

*  Description  :  Saves  the  screen  contents  in  a  buffer.  * 

*  Input  parameters  :  -  SPTR  »  pointer  to  the  buffer  in  which  the  * 

*  screen  will  be  saved.  * 

*  Return  value  :  none  * 

*  Info  :  It  is  assumed  that  the  buffer  is  large  enough  to  * 

*  hold  the  screen  contents.  * 


***********************************************************************/ 


void  save_screen  (  union  vel  *  sptr  ) 

{ 

register  VP  Iptr;  /*  running  pointer  for  accessing  the  video  RAM  */ 
unsigned  i;  /*  loop  counter  */ 

Iptr  =  VPOS(0,  0);  /*  set  pointer  in  the  video  RAM  */ 

for  (i=0;  i<2000;  i++)  /*  run  through  the  2000  screen  positions  */ 

(sptr++) ->x. contents  =  (lptr++) ->x. contents;  /*  save  char.  &  attr.  */ 

} 
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/***************** ***★***★*★*★ ******************** ***★*★ ******* ***★***★★ 
*  Function  rRESTORE  SCREEN  * 


*  Description  :  Copies  the  contents  of  a  buffer  into  the  video  * 

*  RAM.  * 

*  Input  parameters  :  -  SPTR  *  pointer  to  the  buffer  in  which  the  * 

*  screen  contents  are  located  * 

*  Return  value  :  none  * 

***********************************************************************/ 


void  restore_screen (  union  vel 
{ 

register  VP  Iptr; 
unsigned  i; 

Iptr  -  VPOS(0,  0); 


*  sptr  ) 

/*  pointer  for  accessing  the  video  RAM  */ 
/★  loop  counter  */ 
/*  set  pointer  to  the  video  RAM  */ 


for  (i=0;  i<2000;  i++)  /*  run  through  the  2000  screen  positions  */ 

(lptr++)->x. contents  »  (sptr++) ->x. contents;  /*  restore  char.&attr.*/ 

} 


/***************************** *★★*** ************************** ********** 


*  Function  :  E  N  D  F  T  N  * 

** _ ** 

*  Description  :  Called  when  the  TSR  program  is  reinstalled.  * 


*  Input  parameters  :  none  * 

*  Return  value  :  none  * 

***********************************************************************/ 


void  endftn(  void  ) 

{ 

/* —  release  the  allocated  buffers  - */ 


free(  blank_line  );  /*  release  the  allocated  buffer  */ 

free(  (void  *)  scrbuf  );  /*  release  the  buffer  */ 

printf(**The  TSR  program  was  activated  %u  times. Xn",  atimes)  ; 

} 

/*********************************************************************** 

*  Function  :  T  S  R  * 

** _ ** 

*  Description  :  Called  by  the  assembler  routine  when  the  hotkey  * 

*  is  pressed.  * 

*  Input  parameters  :  none  * 

*  Return  value  ;  none  * 

***********************************************************************/ 


void  tsr(  void  ) 

{ 

BYTE  i;  /*  loop  counter  */ 


++atimes; 
dlsp__lnlt  0  ; 
save_screen (  scrbuf  ) ; 
for  (i=0;  i<25;  i++) 


/*  Increment  the  number  of  activations 
/*  determine  address  of  the  video  RAM 
/*  save  the  current  screen  contents 
/*  run  through  the  25  screen  lines 


disp_print (0,  i,  INV,  blank_line) ;  /*  clear  the  line 

disp_print (22,  11,  INV,  "TSRC  -  (c)  1988  by  MICHAEL  TISCHER") ; 

disp_print (28,  13,  INV,  "Please  press  a  key  ..."); 

getchO;  /*  wait  for  a  key 

restore_screen  (  scrbuf  );  /*  copy  the  old  screen  back 

} 


*/ 

*/ 

*/ 

*/ 

*/ 


*/ 

*/ 


/**********************************************************************/ 
/**  MAIN  PROGRAM  **/ 

/**********************************************************************/ 


void  mainO 

{ 

printf("TSRC  -  (c)  1988  by  MICHAEL  TISCHER\n\n") ; 

if  (  is_inst (  id_string  )  )  /*  is  the  program  already  Installed?  */ 
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{  /*  yes  */ 

print f  (**TSRC  was  already  installed — now  disabling. Xn") ; 

uninst (  endftn  );  /*  reinstall  prg.,  call  ftn.  ENDFKT  */ 

/* —  if  no  end  function  is  to  be  called,  the  call  is: - */ 

/*—  uninst  (  NO_END_FTN  );  - */ 

} 

else  /*  no,  the  program  has  not  been  installed  yet  */ 

{ 

/* —  with  MSC  the  heap  buffers  must  be  allocated  now - */ 

scrbuf  *  (union  vel  *)  malloc(80  *  25  *  sizeof (union  vel)); 
blanJc_line  =  (char  *)  sbr)c(  80  +  1  ) ;  /*  allocate  buffer  */ 

* (blank_line  +  80  )  =  '\0';  /*  terminate  buffer  with  NUL  ♦/ 

memset (blank_llne,  •  ',  80);  /*  fill  the  buffer  with  spaces  */ 

printf  C'TSRC  now  enabled  -  Start:  <LSHIFT>  +  <RSHIFT>\n'')  ; 
tsr_init(TC,  tsr,  RSHIFT  |  LSHIFT,  HEAP_FREE,  id_string) ; 

} 


Assembler  listing:  TSRCA.ASM 


.*★★*★★★*★**★**************★*★*★*★★*★*★**★**★★*****★*★★*★**★**★**★**★★*• 

;*  T  s  R  c  A  *; 

•  * 

Description 

:  represents  the  assembler  interface  to  a 

★ 

•  ★ 

C  program  which  can  be  activated  by  a  hotkey 

* 

•  ★ 
r 

as  a  TSR  program. 

★ 

r 

•  * 

Author 

:  MICHAEL  TISCHER 

★ 

•  * 

developed  on 

:  08/10/1988 

* 

•  * 

r 

•  ★— 

last  update 

:  05/26/1989 

* 

_ ★ 

/ 

•  it 

to  assemble 

:  MASM  TSRCA; 

★ 

•  ★ 

. . .  ccxnbine  with  C  program 

★ 

.  *********** *************************************************** **★****★• 

IGROUP 

group  _text 

DGROUP 

group  const, _bss,  j 
assume  CS: IGROUP,  DS 

CONST 

segment  word  public 

CONST 

ends 

BSS 

segment  word  public 

_BSS 

ends 

_DATA 

segment  word  public 

extrn 

_ ^psp  :  word 

/combination  of  program  segments 
/combination  of  data  segments 
P,  ES:DGROUP,  SS:DGROUP 

•/this  segment  holds  all  read-only 
/constants 

/this  segment  stores  all  uninitia 
/static  variables 


/variables  are  stored  in  this 
; segment 

/segment  addr  of  the  PSP  of  the  C  prg 


DATA  ends 


; *=  Constants  *========*==*=========*==«==*====*===**====*====*==*===== 

MAX_ID_LEN  equ  16  /maximum  length  of  the  ID  string 

TC_STACK  equ  512  ;512  bytes  are  reserved  for  the  stack 

/with  TURBO-C 


;  ==  Program  ===*===================:=====*===*======*=========*= 

_TEXT  segment  byte  public  'CODE'  /the  program  segment 

; —  Reference  to  external  (C)  functions - - - 

extrn  _sbrk:near  /returns  end  address  of  the  heap 
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. —  Public  declarations  of  internal  functions - - - 

public  _tsr_init  /allows  call  fran  C  program 

public  _is__inst 

public  _uninst 


; —  Variables  for  the  interrupt  handler  — 
; —  (only  accessible  via  the  code  segment) 


id_buf  db  (MAX_ID_LEN  +  1)  dup  (0)  /buffer  for  the  ID  string 
ce_ptr  equ  this  dword  /points  to  the  routine  CALL_END 

ce_ofs  dw  offset  call_end  /in  the  already-installed  TSR  program 

ce_seg  dw  ? 

; —  Variables  needed  for  activation  of  the  C  program  - 


c__ss  dw  0 
c_sp  dw  0 
c_ds  dw  0 
c  es  dw  0 


;C  stack  segment 
/C  stack  pointer 
/C  data  segment 
/C  extra  segment 


c_dta_ofs  dw  0 
c_dta_seg  dw  0 


/DTA  address  of  the  C  program 


c_psp  dw  0 
break_adr  dw  0 
fkt  adr  dw  0 


/segment  addr  of  the  PSP  of  the  C  prg 
/break  address  of  the  heap 
/address  of  the  C  TSR  function 


/ —  Variables  for  testing  for  the  hotkey 


key_mask 

dw  0 

/hotkey  mark  for  BIOS  keyboard  flag 

recur 

db  0 

/prevents  recursive  TSR  calls 

in_bios 

db  0 

/shows  activity  of  the  BIOS  disk 

daptr 

equ  this  dword 

/ interrupt 

/pointer  to  the  DOS  Indos  flag 

daptr_ofs 

dw  0 

/offset  address 

daptr_seg 

dw  0 

/segment  address 

/ —  The  following  variables  store  the  old  addresses  of  the  Interrupt  - 

; —  handler,  which  will  be  replaced  by  the  new  interrupt  handler  - 


int9_ptr 

equ  this 

dword 

int 9  ofs 

dw  0 

int9_seg 

dw  0 

int 13  ptr 

equ  this 

dword 

int 13  ofs 

dw  0 

intl3_seg 

dw  0 

int 28  ptr 

equ  this 

dword 

int28  ofs 

dw  0 

int28_seg 

dw  0 

/ —  Variables  which 

store  the 

/ —  program. 

u  dta  ofs 

dw  0 

u_dta_seg 

dw  0 

u_psp 

dw  0 

uprg  SS 

dw  0 

uprg_sp 

dw  0 

/old  interrupt  vector  9h 

/offset  address  of  the  old  handler 

/segment  address  of  the  old  handler 

/old  interrupt  vector  13h 
/offset  address  of  the  old  handler 
/segment  address  of  the  old  handler 

/old  interrupt  vbector  28h 
/offset  address  of  the  old  handler 
/segment  address  of  the  old  handler 

information  of  the  interrupted  - 


;DTA  address  of  interrupted  program 


/segment  addr  of  the  PSP  of  int.  prg. 
/SS  and  SP  of  the  interrupted  prg. 


—  TSR_INIT:  ends  the  C  program  and  makes  the  new  interrupt 
interrupt  handler  active 
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; —  Call  from  C:  void  tsr_init(  bool  TC, 

; —  void  (fkt  *)  (void) , 

; —  int  )cey_mask, 

; —  unsigned  heapj:^e, 

; —  char  *  id_string  )  ; 


_tsr_init 

proc  near 

sframeO 

St  rue 

/structure  for  accessing  the  stack 

bpO 

dw  ? 

/stores  BP 

ret  adrO 

dw  ? 

/return  address 

tcO 

dw  ? 

/cortpiler  (1  -  TURBO-C,  0  »  MSC  ) 

fktptrO 

dw  ? 

/pointer  to  C  TSR  function 

keymaskO 

dw  ? 

/mask  for  hotkey 

heapO 

dw  ? 

/heap  bytes  required 

idptrO 

dw  ? 

/pointer  to  the  ID  string 

SframeO 

ends 

/end  of  the  structure 

frame 

equ  [  bp  -  bpO  ] 

push  hp 

/store  BP  on  the  stack 

mov  bp,  sp 

/move  SP  to  BP 

; —  save  the  C  segment 

registers  - 

mov  cs:c  ss,ss 

/store  the  registers  in  the 

mov  cs : c  sp,  sp 
mov  cs:c_es,es 
mov  cs:c_ds,ds 

/corresponding  variables 

; —  copy  the  ID  string 

into  the  internal  buffer  - 

mov  si, frame . idptrO 

/DS:SI  now  points  to  the  string 

push  cs 

/move  CS  to  the  stack 

pop  es 

/and  restore  as  ES 

mov  di, offset  id  buf 

/ES:DI  now  points  to  ID_BUF 

mov  cx,MAX_ID_LEN 

/copy  maxmimum  of  MAX_ID_LEN  chars 

tiO: 

lodsb 

/get  character  from  string 

stosb 

/and  place  in  internal  buffer 

or  al,al 

/test  for  end  of  string 

loopne  tiO 

/continue  if  char!«0  and  CX!*0 

; —  store  the  parameters  passed  - 

mov  ax, frame . fktptrO 

/get  pointer  to  the  C  TSR  function 

mov  cs : f kt  adr, ax 

/and  save 

mov  ax, frame. keymaskO 

/get  mask  for  hotkey 

mov  cs :  keyjmask ,  ax 

/and  save 

; — 

deteimine  DTA  address  of  the  C  program  - 

mov 

ah,2fh 

/ftn.  no.:  get  DTA  address 

int 

21h 

/call  DOS  interrupt 

mov 

cs:c  dta  ofs,bx 

/store  address  in  the  corresponding 

mov 

cs : c_dta_seg, es 

/variables 

! 

determine  address 

of  the  INDOS  flag  - 

mov 

ah,34h 

/ftn.  no.:  get  addr  of  the  INDOS  flag 

int 

21h 

/call  DOS  interrupt 

mov 

cs :  daptr_of  s,  bx 

/save  address  in  the  corresponding 

mov 

cs : dapt r_seg, es 

/variables 

get  the  addresses 

of  the  interrupt  handler  - 

mov 

ax,3509h 

/get  interrupt  vector  9h 

int 

21h 

/call  DOS  interrupt 

mov 

cs:int9_Qfs,bx 

/save  address  of  the  handler  in  the 

mov 

cs:int9_seg,es 

/appropriate  variable 
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mov 

ax,3513h 

;get  interrupt  vector  13h 

int 

21h 

;call  DOS  interrupt 

mov 

cs:intl3  ofs,bx 

/store  address  of  the  handler  in  the 

mov 

cs:lntl3_seg,es 

/corresponding  variables 

mov 

ax,3528h 

/get  interrupt  vector  28h 

int 

21h 

/call  DOS  interrupt 

mov 

cs:int28  ofs,bx 

/store  address  of  the  handler  in  the 

mov 

cs : int28_seg, es 

/corresponding  variables 

Install  the  new  Interrupt  handlers  - 

push  ds 

/save  data  segment 

mov 

mov 

ax,  cs 
ds,ax 

/CS  to  AX  and  then  load  into  DS 

mov 

ax,2509h 

/ftn.  no.:  set  interrupt  9h 

mov 

dx, offset  lnt09 

/DS:DX  stores  the  addr  of  the  handler 

int 

21h 

/call  DOS  interrupt 

mov 

ax,2513h 

/ftn.  no.:  set  interrupt  13h 

mov 

dx, offset  intl3 

/DS:DX  stores  the  addr  of  the  handler 

int 

21h 

/call  DOS  interrupt 

mov 

ax, 2528h 

/ftn.  no.:  set  interrupt  28h 

mov 

dx, offset  int28 

/DS:DX  stores  the  addr  of  the  handler 

int 

21h 

/call  DOS  interrupt 

pop 

ds 

/restore  DS  from  stack 

calculatre  number 

of  paragraphs  which  must  remain  - 

; — 

in  memory. 

xor 

ax,  ax 

/determine  current  break  address 

push  ax 

/as  argument  for  SBRK  on  the  stack 

call  _sbrk 

/call  C  function  SBRK 

;AX  contains  the  end  addr  of  the  heap 


pop  cx  ;get  argument  from  stack  again 

add  ax, frame. heapO  ;add  required  heap  memory 


; —  With  TURBO-C  the  stack  is  found  behind  the  heap  and  — 
; —  begins  with  the  end  of  the  segment.  It  must  thus 
; —  be  moved  near  the  heap. 

cmp  byte  ptr  frame. tc0,0  ;using  TURBO-C? 
je  msc  ;no,  MSC 

add  ax,TC_STACK-l  ; calculate  new  stack  pointer  for  TC 

mov  cs:c_sp,ax  ;and  store 

inc  ax  ;set  break  address 

; —  Calculate  number  of  paragraphs  which  must  remain  - 

; —  resident  in  memory. 


msc: 


mov 

dx,ax 

/get  break  address  into  DX 

add 

dx,15 

/avoid  loss  through  integer  division 

mov 

cl,  4 

/shift  4  times  to  the  right  and  then 

shr 

dx,cl 

/divide  by  16 

mov 

ax,ds 

/move  AX  to  DS 

mov 

bx, _ psp 

/get  segment  address  of  the  PSP 

mov 

cs :  c_psp,  bx 

/save  in  a  variable 

sub 

ax,bx 

/ subtract  DS  from  PSP 

add 

dx,  ax 

/and  add  to  the  number  of  paragraphs 

mov 

ax,3100h 

/ftn.  no.:  end  resident  program 

int 

21h 

/call  DOS  interrupt  and  end  program 

_tsr_init  endp 
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; —  IS_INST:  determines  if  the  program  is  already  Installed  - 

Call 

from  C 

:  int  ist  inst  ( 

char  *  id  string  ) ; 

; —  Return  value:  1,  if  the  program  was  already  installed,  else  0 

_is_inst 

proc 

near 

sframel 

struc 

/structure  for  accessing  the  stack 

bpl 

dw  ? 

/hold  BP 

ret  adrl 

dw  ? 

/return  address 

Idptrl 

dw  ? 

/pointer  to  the  ID  string 

sframel 

ends 

/end  of  the  structure 

frame 

equ 

[  bp  -  bpl  ] 

push  kp 

/save  BP  on  the  stack 

roov 

bp,  sp 

/move  SP  to  BP 

push  di 

/save  DI  on  the  stack 

push  si 

/save  SI  on  the  stack 

push  es 

/save  ES  on  the  stack 

; —  determine  segment 

address  of  the  current  int  9  handler  — 

mov 

ax,3509h 

/get  Interrupt  vector  9h 

int 

21h 

/DOS  interrupt  puts  seg  addr  in  ES 

mov 

di, offset  id  buf 

/ES:DI  points  to  installed  ID  BUF 

mov 

si,  frame. idptrl 

/DS:SI  points  to  the  ID_STRING  passed 

mov 

cx,0 

/return  code:  not  Installed 

isiO: 

lodsb 

/load  character  frcxn  the  string 

cirp 

al,es: [di] 

/compare  to  other  string 

jne 

not  inst 

/not  equal  — >  NOT_INST 

inc 

di 

/increment  pointer  in  Strlng2 

or 

al,al 

/end  of  string  reached? 

jne 

isiO 

/no,  keep  comparing  — >  ISIO 

mov 

cl,l 

/yes  — >  the  program  is  installed 

not_inst: 

mov 

ax,  cx 

/get  return  code  from  ax 

pop 

es 

/restore  saved  registers  from  stack 

pop 

si 

pop 

di 

pop 

bp 

ret 

/back  to  the  caller 

_ls_inst 

endp 

/end  of  the  procedure 

• —  CALL_END:  calls  the  end  function  on  reinstallation  of  the  TSR - 

program. 


—  Input  :  DI  *  offset  address  of  the  routine  to  be  called 


/ —  Info 

:  This  function 

is  not  intended  to  be  called  by  a  C  program. 

call_end 

proc  far 

call  di 

/call  the  end  function 

ret 

/back  to  the  caller 

call_end 

endp 

—  UNINST;  reinstalls  the  TSR  program  and  releases  the  allocated  - 

—  memory  again. 

—  Call  from  C  :  void  uninst (  void  (endfkt  *)  (  void  )  ); 

—  Info  :  if  the  value  -1  (Oxffff)  is  passed  as  the  pointer  to 

the  end  function,  no  end  function  will  be  called. 

—  Note  :  This  function  should  be  called  only  when  a  prior  call 

to  IS_INST(>  has  returned  the  value  1. 

uninst  proc  near 


sframe2  struc 


/structure  for  accessing  the  stack 
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bp2 

ret_adr2 

ftnptr2 

sfraine2 

frame 


dw  ? 

; stores  BP 

dw  ? 

; return  address 

dw  ? 

;polnter  to  the  end  function 

ends 

;end  of  the  structure 

equ 

[  bp  -  bp2  ] 

assume  es :  IGRCXJP 

; allow  access  to  the  CS  variables 

;via  ES 

push  1:^ 

;save  BP  on  the  stack 

mov 

bp,  sp 

;move  SP  to  BP 

push  dl 

; store  DI  on  the  stack 

push  si 

; store  SI  on  the  stack 

push  ds 

; store  DS  on  the  stack 

push  es 

; store  ES  on  the  stack 

determine  the  seg 

addr  of  the  current  int  9  handler  - 

mov 

ax,3509h 

;get  interrupt  vector  9h 

int 

21h 

;DOS  interrupt  puts  seg  addr  in  ES 

mov 

di,  frame .  ftnptr2 

;get  address  of  the  end  function 

C3np 

di,0ffffh 

;no  end  function  called? 

je 

no_endftn 

;NO - >  NO_ENDFTN 

• 

Perform  context  switch  to  C  program  and  execute  - 

; —  the  specified  end 

funtion 

mov 

cs :  ce_seg,  es 

;save  ES  in  jmrp  vector 

mov 

cs:uprg  ss,ss 

;save  current  stack  segment  and 

mov 

cs:uprg_sp,sp 

; stack  pointer 

cli 

; allow  no  more  interrupts 

mov 

ss,es:c  ss 

; activate  the  stack  of  the  TSR 

mov 

sp, es : c_sp 

/program 

sti 

/allow  interrupts  again 

push 

es 

/save  ES  on  the  stack 

mov 

ah, 2f h 

/ftn.  no.;  get  DTA  address 

int 

21h 

/call  DOS  interrupt 

mov 

cs:u  dta  ofs,bx 

/save  address  of  the  DTA  of  the 

mov 

cs:u  dta  seg,es 

/interrupted  program 

pop 

es 

/get  ES  back  from  the  stack 

mov 

ah, 50h 

/ftn.  no.;  set  address  of  the  PSP 

mov 

bx, es:c  psp 

/get  seg  addr  of  the  PSP  of  the  C  prg 

int 

21h 

/call  DOS  interrupt 

push 

ds 

/save  ES  and  DS  on  the  stack 

push 

es 

mov 

ah, lah 

/ftn.  no.;  set  DTA  address 

mov 

dx,es:c  dta  ofs 

/get  offset  address  of  the  new  DTA 

mov 

ds,es:c  dta  seg 

/and  segment  address  of  the  new  DTA 

int 

21h 

/call  DOS  interrupt 

mov 

ds,es:c_ds 

/set  segment  register  for  the 

mov 

es,es:c  es 

/C  program 

call 

cs; [ce_ptr] 

/call  the  function 

1 

perform  context  change  to  the  interrupt  program  - 

mov 

ah, lah 

/ftn.  no.;  set  DTA  address 

mov 

dx, cs:u  dta  ofs 

/load  offset  and  segment  address  of 

mov 

ds,cs:u  dta  seg 

/the  interrupted  program 

int 

21h 

/call  DOS  Interrupt 

pop 

es 

/seg  addr  of  the  TSR  prog  from  stack 

pop 

ds 

/restore  DS  from  stack 
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mov  ah, 50h 

mov  bx, _ psp 

int  21h 


;ftn.  no.:  set  address  of  the  PSP 
;load  seg  addr  of  the  PSP 
;call  DOS  interrupt 


cli 

mov  ss, cs : uprg_ss 
mov  sp, cs : uprg_sp 
sti 


; don't  allow  Interrupts 
; restore  stack  pointer  and  stack 
; segment 

; allow  Interrupts  again 


; — reinstall  the  interrupt  handler  of  the  TSR 
; —  program 


no_endftn:  cli 

mov  ax, 2509h 
mov  ds,es:int9_seg 
mov  dx,  es :  int  9_of  s 
int  21h 

mov  ax,2513h 
mov  ds,es:intl3_seg 
mov  dx,es:intl3_ofs 
int  21h 

mov  ax, 2528h 
mov  ds,es:int28_seg 
mov  dx,es:int28_ofs 
int  21h 

sti 

mov  es,es;c_psp 
mov  cx, es 
mov  es,es:[  02ch  ] 
mov  ah,49h 
int  21h 

mov  es, cx 
mov  ah,49h 
int  21h 

pop  es 
pop  ds 
pop  si 
pop  dl 

pop  bp 
ret 

assume  es:DGROUP 
_unlnst  endp 


/don't  allow  interrupts 
;ftn.  no.;  set  handler  for  int  9 
/segment  address  of  the  old  handler 
/offset  address  of  the  old  handler 
/install  the  old  handler  again 

/ftn.  no.:  set  handler  for  int  13 
/segment  address  of  the  old  handler 
/offset  address  of  the  old  handler 
/reinstall  the  old  handler 

/ftn.  no.;  set  handler  for  int  28 
/segment  address  of  the  old  handler 
/offset  address  of  the  old  handler 
/reinstall  the  old  handler 

/allow  Interrupts  again 

/seg  addr  of  the  PSP  of  the  TSR  prg 
/save  in  CX 

/get  seg  addr  of  environment  from  PSP 
/ftn.  no.:  release  allocated  memory 
/call  DOS  interrupt 

/restore  ES  from  CX 

/ftn.  no.:  release  allocated  memoru 

/call  DOS  interrupt 

/get  the  saved  registers  back  from 
/the  stack 


/back  to  the  called 
/combine  ES  with  DGROUP  again 
/end  of  the  procedure 


/ —  The  new  interrupt  routine  follows 


/ —  The  new  interrupt  09h  handler - - 

int09  proc  far 

pushf  /simulate  the  call  of  the  old  handler 

call  cs:int9_ptr  /via  the  INT  9h  instruction 

cli  /suppress  interrupts 

cnp  cs: recur, 0  /is  the  TSR  prog  already  active? 

jne  ikjend  /YES:  back  to  the  called  of  int  9 

/ —  test  to  see  if  the  BIOS  disk  int  is  being  executed  now 

cmp  cs;in_bios,0  /BIOS  disk  interrupt  active? 
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jne  l)c_end  ;yes  — >  back  to  the  caller 

; —  BIOS  disk  interrupt  not  active,  test  for  hotkey 


;save  ES  and  AX  on  the  stack 

/set  ES  to  the  lowest  memory  segment 


push  ax 
push  es 
xor  ax, ax 
mov  es, ax 

mov  ax, word  ptr  es:[417h]  /get  BIOS  keyboard  flag 
and  ax,cs:keyjnask  /mask  out  the  non-hotkey  bits 

cnp  ax,cs:keyjnask  /are  only  the  hotkey  bits  left? 

pop  es  /get  ES  and  AX 

pop  ax 

jne  Ikjend  /hotkey  discovered?  no  — >  back 


/ —  the  hotkey  was  pressed,  test  to  see  if  DOS  is  active 


push  ds 
push  bx 

Ids  bx,cs:daptr 
cmp  byte  ptr  [bx],0 
pop  bx 
pop  ds 
jne  ik__end 


/save  DS  and  BX  on  the  stack 

/DS:BX  now  point  to  the  INDOS  flag 
/DOS  function  active? 

/restore  BX  and  DS  from  the  stack 

/DOS  function  active  — >  IK_END 


/ —  DOS  is  not  active,  activatr  TSR  program  - 

call  start_tsr  /start  the  TSR  program 

ik_end:  iret  /back  to  the  interrupted  program 

into 9  endp 

/ —  the  new  interrupt  13h  handler  - 


lntl3 


intl3 


proc  far 


mov  cs:in_bios,l 
pushf 

call  cs:intl3_ptr 
mov  cs:in_bios,  0 


/set  flag  and  show  that  the  BIOS  disk 

/interrupt  is  active 

/call  the  old  interrupt  handler 

/simulate  via  int  13h 

/BIOS  disk  interrupt  no  longer  active 


ret  2 
endp 


/back  to  the  caller,  but  don't  remove 
/the  flag  reg  frcxn  the  stack  first 


/ —  the  new  interrupt  28h  handler 
int28  proc  far 


pushf 

call  cs:lnt28_ptr 


/simulate  calling  the  old  Interrupt 
/handler  via  int  28h 


cli 

cmp  cs : recur, 0 
je  idOl 
id  end:  iret 


/suppress  further  interrupts 

/is  the  TSR  program  already  active? 

/NO - >  IDOl 

/YES  - >  back  to  the  caller 


/ —  the  TSR  program  is 


not  yet  active 


idOl: 


cmp  cs :  i n_bios ,  0 
jne  idjend 


/BIOS  disk  interrupt  active? 
/YES  — >  back  to  the  caller 


; —  BIOS  disk  interrupt  not  active,  test  for  hotkey 


push  ax  /save  ES  and  AX  on  the  stack 

push  es 

xor  ax, ax  /st  ES  to  the  lowest  memory  segment 

mov  es,ax 

mov  ax, word  ptr  es: [417h]  /get  BIOS  keyboard  flag 
and  ax, cs:key_mask  /mask  out  the  non-hotkey  bits 
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int28 

START 
start  tsr 


tsrsl : 


cnqp 

ax,cs:)ceyjnask 

;are  only  the  hotkey  bits  left? 

pop 

es 

; restore  ES  and  AX 

pop 

ax 

jne 

lk_end 

/hotkey  discovered?  NO  — >  back 

call 

start_tsr 

/start  the  TSR  program 

iret 

/back  to  the  interrupted  program 

endp 


TSR:  i 

activate  the  TSR  program  - 

proc 

near 

mov 

cs: recur,  1 

/set  TSR  recursion  flag 

/ —  perform  context  change  to  the  C  program - 

mov 

cs:uprg  ss,ss 

/save  current  stack  segment  and 

mov 

cs:uprg_sp, sp 

/stack  pointer 

mov 

ss,  cs:c__ss 

/activate  the  C  program's  stack 

mov 

sp,  cs :  c_sp 

push 

ax 

/save  the  processor  registers  on  the 

push 

bx 

/C  stack 

push 

cx 

push 

dx 

push 

bp 

push 

si 

push 

di 

push 

ds 

push 

es 

save  64  words  from  the  DOS  stack  - 

mov 

cx,  64 

/loop  counter 

mov 

ds,cs:uprg  ss 

/set  DS:SI  to  the  end  of  the  DOS  stack 

mov 

si,cs:uprg_sp 

push  word  ptr  [si] 

/save  word  from  the  DOS  stack  to  the 

inc 

si 

/C  stack  and  set  SI  to  the  next 

inc 

si 

/stack  word 

loop  tsrsl 

/process  all  64  words 

mov 

ah,51h 

/ftn,  no.:  determine  address  of  PSP 

int 

21h 

/call  DOS  interrupt 

mov 

cs:u_psp,bx 

/save  segment  address  of  the  PSP 

mov 

ah,2fh 

/ftn.  no.:  get  DTA  address 

int 

21h 

/call  DOS  interrupt 

mov 

cs:u  dta  ofs,bx 

/store  address  of  the  DTA  of  the 

mov 

cs : u_dt a_seg, es 

/interrupted  program 

mov 

ah, 50h 

/ftn.  no.;  set  address  of  the  PSP 

mov 

bx,  cs:c_psp 

/get  seg  addr  of  the  PSP  of  the  C  prg 

int 

21h 

/call  DOS  interrupt 

mov 

ah,lah 

/ftn.  no.;  set  DTA  address 

mov 

dx, cs:c  dta  ofs 

/get  offset  address  of  the  new  DTA 

mov 

ds, cs:c  dta  seg 

/and  the  segment  address  of  new  DTA 

int 

21h 

/call  DOS  interrupt 

mov 

ds, cs:c_ds 

/set  segment  register  for  the  C 

mov 

es,cs:c_es 

/program 

sti 

/allow  interrupts  again 

call 

cs:fkt  adr 

/call  the  start  function  of  the  C  prg. 

cli 

/disable  interrupts 
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; —  perform  context  change  to  the  Interrupted  program  - 


mov  ah, lah 
mov  dx,  cs :  ujdtajof  s 
mov  ds ,  cs :  u__dt  a__seg 
Int  21h 

mov  ah, 50h 
mov  bx, cs : u_psp 
Int  21h 


;ftn.  no.;  set  DTA  address 
;load  offset  and  segment  addresses 
;of  the  DTA  of  the  interrupted  program 
;call  DOS  Interrupt 

;ftn,  no.:  set  address  of  the  PSP 
;seg  addr  PSP  of  the  Interrupted  prg. 
/call  DOS  interrupt 


tsrs2; 


; —  restore  DOS  stack  again 


mov  cx, 64 

mov  ds, cs : uprg_ss 

mov  si , cs : uprg_sp 

add  si, 128 

dec  si 

dec  si 

pop  word  ptr  [si] 
loop  tsrs2 

pop  es 
pop  ds 
pop  di 
pop  si 
pop  bp 
pop  dx 
pop  cx 
pop  bx 
pop  ax 

mov  ss ,  cs ;  uprg__ss 
mov  sp,  cs ;  uprg_sp 

mov  cs ; recur,  0 
ret 


/loop  counter 

/load  DS;SI  with  the  end  address  of 
/the  DOS  stack 

/set  SI  to  the  start  of  the  DOS  stack 
/SI  to  the  previous  stack  word 

/get  word  from  the  C  stack  to  DOS  stack 
/process  all  64  words 

/restore  the  saved  registers  from  the 
/C  stack 


/reset  stack  pointer  and  stack  segment 
/of  the  Interrupted  program 

/ reset  TSR  recursion  flag 
/back  to  the  caller 


start_tsr  endp 


text  ends 

end 


/end  of  the  code  segment 
/end  of  the  program 


Turbo  Pascal  offers  only  one  memory  model,  unlike  the  various  C  compiles.  The 
organization  of  this  model  is  well  suited  to  TSR  programs. 


Prof  lx_S«g  — ^ 


4 


Global  varlablos 


Pxodoflnod  constants 


Runtlroo  library  routinos 


Additional  unit  routinos 


Program  codo 


4 


Incroaslng 

memory 

addresses 


Memory  layout  of  a  Pascal  program  under  Turbo  Pascal  4.0 
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The  figure  above  shows  that  the  program  code  and  the  required  routines  from  die 
various  units  and  the  runtime  library  follow  the  PSP.  After  these  are  the  predefined 
constants,  the  global  data,  and  the  stack  segment.  While  the  size  of  these  program 
components  are  set  at  compilation  and  cannot  be  changed  after  the  program  is 
loaded  into  memory,  this  doesn't  apply  to  the  size  of  the  heap,  which  follows  the 
stack  segment.  When  new  objects  are  created  with  the  NEW  command,  the  heap 
grows  toward  the  end  of  memory. 

Turbo  Pascal  offers  the  significant  advantage  over  C  compilers  of  being  able  to  set 
the  maximum  size  of  the  heap,  as  well  as  the  stack  size,  with  a  compile  directive 
inside  the  source  code.  This  is  the  $M  directive,  which  must  be  passed  the 
following  parameters: 


{ $M  stack  size,  minimum  heap  size,  maximum  heap  size} 

All  specifications  are  in  bytes,  so  the  directive 

{$M  2048,  0,  5000) 

results  in  a  2K  stack  and  a  maximum  5000-byte  heap.  If  no  such  directive  is  found 
in  a  program,  the  heap  is  not  limited  and  it  can  grow  to  the  end  of  main  memory. 
This  would  have  catastrophic  results  for  a  TSR  program,  howevo*,  since  the  entire 
memory  would  have  to  be  reserved  for  the  TSR  program  and  thae  would  be  no 
memory  left  for  additional  programs.  But  with  the  $M  directive  placed  at  the 
beginning  of  the  program,  we  can  set  the  maximum  size  of  the  program  in 
memory  and  the  number  of  paragraphs  which  must  remain  resident  after  the 
program  is  terminated. 

Turbo  Pascal  also  allows  the  number  of  paragr^hs  to  be  reserved  to  be  calculated 
from  the  Pascal  program,  eliminating  the  complicated  calculation  in  the  assembly 
language  interface.  In  a  C  program,  important  data  needed  for  this  calculation 
(segment  addresses  of  the  PSP  and  data  segment,  and  size  of  the  he^)  are  available 
only  at  the  assembly  language  level,  but  Turbo  Pascal  places  this  information  in 
normal  variables,  which  are  available  to  a  Pascal  program  in  the  fcxm  of  pointers. 
For  our  purposes,  we  need  the  starting  address  of  the  PSP  and  the  end  of  the  heap, 
since  they  mark  the  start  and  end  of  the  TSR  program  in  memory. 

The  figure  shows  that  the  segment  address  of  the  PSP  is  found  in  the  variable 
PrefixSeg,  while  the  end  of  the  heap  is  determined  with  the  help  of  the  pointer 
variable  FreePtr.  This  variable  does  not  point  directly  to  the  end  of  the  heap,  but 
the  segment  portion  of  this  pointer  contains  the  end  address  of  the  heap  minus 
$1000.  This  information  is  used  within  the  TSR  program  in  the  ResPara 
procedure,  which  calculates  the  number  of  paragraphs  to  remain  resident  after  the 
installation  of  the  TSR. 
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In  addition  to  this  information,  the  initialization  routine  Tsrinit  in  the  assembly 
language  module  must  be  passed  the  following  infamadon  (in  the  specified  order): 

•  Address  of  the  Pascal  TSR  function 

•  Hotkey  (mask  for  reading  the  BIOS  keyboard  flag) 

•  Numba  (tf  paragrt^s  to  be  resoved 

•  Identification  string 

The  Pascal  TSR  function,  the  address  of  which  is  passed  as  the  first  parameter  to 
Tsrinit,  must  be  a  {Hocedure  within  the  main  program  and  may  not  be  contained  in 
a  unit.  Moreover,  it  may  not  be  converted  to  a  FAR  procedure  with  the  $F+ 
compiler  directive,  since  the  assembly  language  interface  assumes  that  it  is  a 
NEAR  procedure.  The  address  of  the  procedure  is  determined  with  the  help  of  the 
function  OFS  and  passed  to  Tsrinit,  since  Turbo  Pascal  would  otherwise  place 
both  the  offset  address  and  the  segment  address  on  the  stack. 

The  same  applies  to  passing  the  address  of  a  "cleanup"  procedure  to  the  function 
Uninst,  which  reinstalls  the  TSR  program.  If  such  an  address  is  passed,  the 
cmresponding  procedure  within  the  installed  TSR  jnogram  will  be  called  before  the 
reinstdlation.  If  the  value  $FFFF  is  passed  as  the  address  of  this  procedure,  this 
tells  the  assembly  language  function  that  no  "cleanup"  procedure  is  to  be  called. 
To  improve  the  readability  of  the  listing,  the  constant  NO_END_FrN  is  defined  in 
the  constant  definitions  at  the  start  of  the  listing.  NO_END_FTN  is  given  the 
value  $FFFF  and  should  be  used  when  calling  die  assembly  language  function 
Uninst. 

The  following  listing  can  answer  any  additicxial  questions  you  may  have,  and  will 
make  a  good  starting  point  for  your  own  TSR  programs. 

Pascal  listing:  TSRP.PAS 


^ ********************************************************************** j 

{*  T  S  R  P  *} 

Description  ;  creates  a  TSR  program  with  the  help  of  an  *} 

1*  assenibly  language  module.  *} 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  on  :  08/18/1988  *} 

{*  last  update  :  05/26/1989  *) 

^ *************************************************************** *******  j 

program  TSRP; 

uses  DOS,  CRT;  {  bind  in  the  DOS  and  CRT  units  } 

1$M  2048,  0,  5120}  {  2KB  for  the  stac)c  and  max.  5KB  for  the  heap  } 

{$L  tsrpa}  (  bind  in  the  assembler  module  ) 

const  LSHIFT  »  1;  {  left  SHIFT  key  } 

RSHIFT  -  2;  {  right  SHIFT  key  } 

CTRL  -  4;  {  CTRL  key  } 
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ALT  «  8; 
SYSREQ  -  1024; 
BREAK  -  4096; 
NUM  «  8192; 
CAPS  -  16384; 
INSERT  -  32768; 


{  ALT  key  } 

SYS  REQ  key  (ST  keyboard  only)  } 
(  BREAK  key  ) 
{  NUM  key  } 
{  CAPS  key  } 
{  INSERT  key  } 


NO__END__FTN  -  $FFFF; 


{  don't  call  an  end  function  } 


type  IdsType  «  string [  16  ];  {  describes  the  identification  string  } 

VBuf  =  array [1.. 25,  1..80]  of  word;  {  describes  the  screen  } 
VPtr  *  '^VBuf;  {  pointer  to  a  screen  buffer  } 

var  IdString  :  IdsType;  {  the  ID  string  for  the  TSR  program  } 

MBuf  :  VBuf  absolute  $8000:0000;  {  the  monochrome  video  RAM  } 

CBuf  :  Vbuf  absolute  $8800:0000;  {  the  color  video  RAM  } 

VioPtr  :  VPtr;  {  pointer  to  the  video  RAM  ) 


{**  Declaration  of  the  external  functions  in  the  assembly  module  ******) 


procedure  Tsrinit (  PrcPtr  :  word; 

Ke^lask  :  word; 

ResPara  :  word;  { 

IdString  :  IdsType  ) 


{  offset  addr  of  the  TSR  proc  } 
{  the  hotkey  (see  CC»IST)  } 
number  of  para,  to  be  reserved  ) 
;  external  ;  {  the  ID  string  } 


function  Isinst (  IdString  :  IdsType  )  :  boolean  ;  external  ; 


procedure  Uninst (  PrcPtr  :  word  );  external;  {  reinstall  TSR  program  ) 


var  ATimes  :  Integer;  {  number  of  TSR  activations  } 

I ********************************************************************** I 

{*  Dlsplnit:  creates  a  pointer  to  the  video  RAM  *} 

{*  Input  :  none  *} 

{*  Output  :  none 

^■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-klfk-k-kifk-k-k-k-k-k-k-k-kifk-k-k-k-k-k-kls-k-k-k-k-k-k-klfklfk-kitlfkltifk-k-k-k-k-k********'^ 


procedure  Dispinit; 

var  Regs:  Registers;  {  stores  the  processor  registers  } 

begin 

Regs. ah  :«  $0f;  {  function  no.  15  *  read  the  video  mode  ) 

Intr($10,  Regs);  {  call  the  BIOS  video  interrupt  } 

if  Regs.al*7  then  {  monochrome  video  card?  } 

VioPtr  :*  @MBuf  {  yes,  set  pointer  to  the  monochrome  video  RAM  } 
else  (  it's  an  EGA,  VGA,  or  CGA  card  } 

VioPtr  :=  @CBuf;  {  set  pointer  to  color  video  RAM  } 

end; 


^  ******* ******«***Ai^**********«*i^* ************* ***^« *4^** **********'(^  I 


{*  SaveScreen:  saves  the  screen  contents  in  a  buffer  *} 

Input  :  SPTR  :  pointer  to  a  buffer  in  which  the  screen  contents  *} 
{*  will  be  saved  *) 

{*  Output  :  none  *} 


I  ******************************************************************* ***j 

procedure  SaveScreen (  SPtr  :  VPtr  ) ; 

var  line, 

column  :  byte; 

begin 

for  line:=l  to  25  do  {  run  through  the  25  screen  lines  } 

for  column: »1  to  80  do  {  run  through  the  80  screen  columns  ) 

SPtr'^tllne,  column]  :*  VioPtr^ [line,  column);  {  save  ch.&attr.  } 


{  the  current  line  } 
{  the  current  column  ) 


end; 
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^  ***★*★****★*★★★****★*★***★*★★★**★★****★*★**★******★*****★*★***★*****★★) 
{*  Rest ores creen:  copies  the  contents  of  a  buffer  into  the  video  RAM  *} 
{*  Input  :  BPTR  :  pointer  to  the  buffer  whose  contents  are  to  be  *) 
{*  copied  into  the  video  RAM  *} 

{*  Output  :  none  *} 

^ ★*★★*★★****★★★★★***★*****★***★**★★★★★★*★★*★**★*★******★*★*★★*** ★★*★★*★ } 


procedure  RestoreScreen (  BPtr  :  VPtr  )  ; 

var  line,  {  the  current  line  } 

column  :  byte;  {  the  current  column  } 

begin 

for  line:»l  to  25  do  {  run  through  the  25  screen  lines  } 

for  column:-!  to  80  do  {  run  through  the  80  screen  columns  } 

VioPtr'^ [line,  column]  :»  BPtr'^[line,  column];  {  get  ch.  &  attr.  } 

end; 

I *★*★*****★★*★*★★***★★★*★******★**★★★**********★***★*★★* ***★★**★★★*★★** } 


[*  ResPara:  calculates  the  number  of  paragraphs  which  must  be  *} 
{*  allocated  for  the  program  *} 
[*  Input  :  none  *} 
{*  Output  :  the  number  of  paragraphs  to  be  reserved  *} 


I ******* ******************************************************** ★**★**★ j 


function  ResPara  :  word; 
begin 

ResPara  Seg  (FreePtr'") +$1000-PrefixSeg;  {  number  of  paragraphs  } 
end; 

****************  it  itititifkitititifkit***  *******  *****************  *11***********^ 


{*  EndProc:  Called  by  the  assembler  module  when  the  TSR  program  is  *} 
{*  reinstalled  *] 
{*  Input  :  none 

{*  Output  :  none  *} 
{*  Info  :  This  procedure  must  be  in  the  main  program  and  may  not  *} 
{*  be  turned  into  a  FAR  procedure  by  the  $F+  coitpiler  *} 
{*  directive.  *} 


J  *****************  **#********^t******A<r*****^^*****  ★*★★★★*★★★*★★★***★*★*★  J 

{$F-}  {  don't  make  a  FAR  procedure  } 

procedure  EndProc; 

begin 

Text Background (  Black  );  {  dark  background  } 

TextColor(  LightGray  );  [  light  text  } 

writeln(*The  TSR  program  was  called  ',  ATimes,  '  times.'); 
end; 

I **★★★★*★★★*★*******************★★**★★*★**********★*****★★★★**★★*★***** j 


*  Tsr:  This  procedure  is  called  by  the  assembler  module  after  the  *} 

*  hotkey  is  pressed.  *J 

*  Input  :  none  *} 

*  Output  :  none  *} 

*  Info  :  This  procedure  must  be  in  the  main  program  and  may  not  *] 

*  be  turned  into  a  FAR  procedure  by  the  $F+  compiler  *} 

*  directive.  *} 


********************************************************************** j 


{$F-] 

procedure  Tsr; 

var  BufPtr  :  VPtr; 
Column, 

Line  :  byte; 
Key  :  char; 


{  don't  make  a  FAR  procedure  J 


{  stores  pointer  to  the  allocated  blocks  } 
{  the  current  screen  column  } 
{  the  current  screen  line  ] 
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begin 

inc(  ATimes  ); 

Dlsplnit; 

GetMem (Buf Ptr,  SlzeOf(VBuf)  ); 

SaveScreen (  BufPtr  ) ; 

Line  WhereY; 

Column  :»  WhereX; 

TextBackground (  LightGray  ) ; 

TextColor(  Black  ); 

ClrScr; 

GotoXY(22,  12); 

write  CTSRP  -  (c)  1988  by  MICHAEL  TISCHER' )  ; 

GotoXY(30,  14); 

write ( ' Please  press  a  key. . . ' )  ; 

Key  ReadKey; 

RestoreScreen (  BufPtr  ) ; 

Fre^fean(  BufPtr,  SizeOf(VBuf)  ); 

GotoXY (  Column,  Line  ) ; 
end; 


{  increment  call  counter  } 
{  determine  address  of  the  video  RAM  } 
{  allocate  buffer  } 
{  save  the  screen  contents  } 
i  get  current  screen  line  } 
{  get  current  screen  column  } 
{  light  background  } 
{  dark  text  } 
{  clear  the  whole  screen  } 


{  wait  for  a  key  } 
{  copy  the  old  screen  contents  back  } 
{  release  allocated  buffer  } 
{  cursor  back  to  original  position  } 


I  ★***★*★★★★**★★*#*  #*^^*^^*^^*  ★*★*★*******★***★******★★*****★♦**★***  ★**★***} 

{**  MAIN  PROGRAM  **} 


begin 

wrlteln CTSRP  -  (c)  1988  by  MICHAEL  TISCHER'); 

IdStrlng  :=  'TROTZKY'; 

if  (  Isinst  (  IdString  )  )  then  {  program  already  installed?  } 

begin  {  YES  } 

writelnCThe  TSR  program  now  disabled.'); 

Uninst  (  Ofs (  EndProc  )  ) ;  {  remove  the  program  } 


{**  if  no  end  function  is  to  be  called,  the  call  is;  ************ 
**  Uninst (  NO_END_FTN  );  ************} 

end 

else  {  the  program  is  not  Installed  yet  } 

begin 

ATimes  :=  0;  {  the  program  was  not  activated  yet  } 

wrlteln ('TSR  program  now  enabled.  Start:  <LSHIFT>  +  ', 

'<RSHIFT>') ; 

Tsrinit  (  Ofs (Tsr) ,  LSHIFT  or  RSHIFT,  ResPara,  IdString  ) ; 
end; 

end. 


Assembler  listing:  TSRPA.ASM 


.************ **************************** *****•*************************; 


T  S  R  P  A 

Description 

:  This  is  the  assembler  Interface  to  a  Turbo 
Pascal  4.0  program  which  can  be  activated 
via  a  hotkey. 

Author 
developed  on 
last  update 

:  MICHAEL  TISCHER 
:  08/12/1988 
:  08/18/1988 

Info 

:  The  module  must  be  in 
be  bound  into  a  UNIT. 

a  program  and  may  not 

to  assemble 

:  MASM  TSRPA; 

...  COTibine  with  a  Turbo  Pascal  program 


.****★***★*★*★**★«*★**★*«*★***********★**★*★***★*★*★*★****★*★*'*********• 


DATA  segment  word  public  ; Turbo  data  segment 

DATA  ends  ;end  of  the  data  segment 
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MAX_ID_LEN  equ  16 


;inaximum  length  of  the  ID  string 


;**  Program  **-*=«»**=*=««—»*=**»«*'=*»»“ 

CGDE  segment  byte  public  ;the  Turbo  code  segment 

assume  cs:CGDE,  ds:DATA,  es:CODE 

; —  Public  declarations  of  internal  functions  - 

public  tsrinit  /allows  access  by  the  Turbo  program 

public  isinst 

public  uninst 


/ —  Variables  for  the  interrupt  handler  - 
; —  (accessible  only  via  the  code  segment 


id  buf 

db 

(MAX  ID  LEN  +  1) 

dup  (0)  /buffer  for  the  ID  string 

ce_ptr 

equ  this  dword 

/points  to  the  routine  CALL_END  in  the 

ce  ofs 

dw 

offset  call  end 

/already-installed  TSR  program 

ce_seg 

dw 

? 

/ —  Variables 

neded  for  activation  of  the  Turbo  program  -  -  - 

t  ss 

dw 

0 

/Turbo  stack  segment 

t  sp 

dw 

0 

/Turbo  stack  pointer 

t  ds 

dw 

0 

/Turbo  data  segment 

t_es 

dw 

0 

/Turbo  extra  segment 

t  dta  ofs 

dw 

0 

/DTA  address  of  the  Turbo  program 

t_dta_seg 

dw 

0 

t_psp 

dw 

0 

/seg  addr  of  the  PSP  of  the  Turbo  prg. 

prc_adr 

dw 

0 

/address  of  the  Turbo  TSR  procedure 

; —  Variables 

for  testing  for  the  hotkey  - 

key  mask 

dw 

0 

/hotkey  mask  for  BIOS  keyboard  flag 

recur 

db 

0 

/prevents  recursive  TSR  calls 

in  bios 

db 

0 

/shows  activity  of  the  BIOS  disk 

/interrupt 

daptr 

equ  this  dword 

/pointer  to  the  DOS  INDOS  flag 

daptr  ofs 

dw 

0 

/offset  address 

daptr_seg 

dw 

0 

/segment  address 

; —  The  following  variables  store  the  old  addresses  of  the  interrupt  - 

; —  handlers  which  will  be  replaced  by  new  interrupt  handlers  - 


int9jptr 

equ  this 

dword 

/old  interrupt  vector  9h 

int9  ofs 

dw  0 

/offset  address  of  the  old  handler 

int9_seg 

dw  0 

/segment  address  of  the  old  handler 

intl3_ptr 

equ  this 

dword 

/old  interrupt  vector  13h 

intl3  ofs 

dw  0 

/offset  address  of  the  old  handler 

intl3_seg 

dw  0 

/segment  address  of  the  old  handler 

int28_ptr 

equ  this 

dword 

/old  Interrupt  handler  28h 

int28_ofs 

dw  0 

/offset  address  of  the  old  handler 

int28_seg 

dw  0 

/segment  address  of  the  old  handler 

/ —  Variables  for  storing  information  about  the  interrupted  - 

/ —  program 

— 

u_dta_ofs 

u_dta_seg 

dw  0 
dw  0 

/DTA  address  of  interrupted  program 

u_psp 

dw  0 

/seg  addr  of  the  PSP  of  the  int.  prg. 
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uprg_ss 

uprg_sp 

o  o 

;SS  and  SP  of  the  interrupted  prg. 

; —  TSRINIT:  ends  the  Turbo  program  and  activates  the  new  interrupt  - 

; — 

handler 

Call 

frcati  Turbo:  procedure  Tsrinit  (  PrzPtr  :  word; 

; — 

KeyMask  :  word; 

; — 

ResPara  :  word; 

; — 

IdString  :  string [16]  ); 

tsrinit 

proc  near 

sframeO 

St  rue 

/structure  for  accessing  the  stack 

1:^0 

dw  ? 

/stores  BP 

ret  adrO 

dw  ? 

/return  address 

idptrO 

dd  ? 

/pointer  to  the  ID  string 

resparaO 

dw  ? 

/number  of  paragraphs  to  be  reserved 

keymaskO 

dw  ? 

/mask  for  hotkey 

prcptrO 

dw  ? 

/pointer  to  the  Turbo  TSR  procedure 

SframeO 

ends 

/end  of  the  structure 

frame 

equ  [  bp  -  bpO  ] 

push  bp 

/save  BP  on  the  stack 

mov  bp, sp 

/move  SP  to  BP 

push  es 

/save  ES  on  the  stack 

; —  save  the  Turbo  segment  registers  - 

mov  cs:t_ss,ss 

/save  the  registers  in  the  appropriate 

mov  cs:t_sp,  sp 

/variables 

mov  cs:t  es,es 

mov  cs:t_ds,ds 

; —  copy  the  ID  string 

into  the  internal  buffer  - 

push  ds 

/save  DS  on  the  stack 

Ids  si, frame. idptrO 

;DS:SI  now  points  to  the  string 

push  cs 

/put  CS  on  the  stack 

pop  es 

/and  restore  as  ES 

mov  di, off set  id  buf 

;ES:DI  now  points  to  ID  BUF 

xor  ch, ch 

/clear  high  byte  of  the  counter 

mov  cl, [si] 

/get  length  of  the  string 

inc  cl 

/copy  the  length  byte  too 

rep  movsb 

/copy  the  entire  string 

pop  ds 

/restore  DS 

; —  determine  PSP  of  the  Turbo  program  - 

mov  bx,  cs 

/transfer  CS  to  BX 

sub  bx, lOh 

;10h  paragraphs  *  subtract  256  bytes 

mov  cs:t_psp,bx 

/save  segment  address 

; —  save  the  parameters  passed - - - 

mov  ax, frame . prcptrO 

/get  pointer  to  the  TSR  procedure 

mov  cs:prc  adr,ax 

/and  save 

mov  ax, frame . keymaskO 

/get  mask  for  the  hotkey 

mov  cs : keyjnask , ax 

/and  save 

; —  determine  DTA  address  of  the  Turbo  program  - 


mov  ah, 2fh  ;ftn.  no.:  get  DTA  address 

int  21h  ;call  DOS  interrupt 

mov  cs:t_dta_ofs,bx  ; store  address  in  the  appropriate 

mov  cs:t_dta_seg,es  /variables 

; —  determine  the  address  of  the  INDOS  flag  - 


438 


Abacus 


8.  Terminate  and  Stay  Resident  Programs 


mov 

ah, 34h 

;ftn.  no.:  get  adr  of  the  INDOS  flag 

int 

21h 

;call  DOS  interrupt 

mov 

cs :  dapt  r_of  s,  bx 

;save  address  in  the  appropriate 

mov 

cs : dapt r_seg,  es 

/variables 

get  the  addresses  of  the  interrupt  handlers  to  change  - 

mov 

ax,3509h 

;get  Interrupt  vector  9h 

int 

21h 

;call  DOS  interrupt 

mov 

cs:int9_ofs,bx 

;save  address  of  the  handler  in  the 

mov 

cs:int9_seg,es 

/appropriate  variables 

mov 

ax,3513h 

/get  interrupt  vector  13h 

int 

21h 

/call  DOS  interrupt 

mov 

cs:intl3_ofs,bx 

/save  address  of  the  handler  in  the 

mov 

cs : int 13_seg, es 

/appropriate  variables 

mov 

ax,3528h 

/get  interrupt  vector  28h 

int 

21h 

/call  DOS  interrupt 

mov 

cs:int28_ofs,bx 

/save  addres  of  the  handler  in  the 

mov 

cs:int28_seg, es 

/appropriate  variables 

; —  install  the  new  interupt  handlers 


push  ds 
mov  ax,  cs 
mov  ds, ax 

/save  data  segment 

;CS  to  AX  and  then  load  into  DS 

mov 

mov 

int 

ax,2509h 
dx,  offset 
21h 

int09 

;ftn.  no.:  set  interrupt  9h 
/DS:DX  stores  the  addr  of  the 
/call  DOS  interrupt 

handler 

mov 

mov 

int 

ax,2513h 
dx, offset 
21h 

lntl3 

;ftn.  no.:  set  interrupt  13h 
;DS:DX  stores  the  addr  of  the 
/call  DOS  interrupt 

handler 

mov 

mov 

int 

ax,2528h 
dx, offset 
21h 

int28 

/ftn.  no.:  set  interrupt  28h 
;DS:DX  stores  the  addr  of  the 
/call  DOS  interrupt 

handler 

pop 

ds 

/get  DS  back  from  the  stack 

; —  End  resident  program 


mov  ax,3100h  ;ftn.  no.:  end  resident  program 

mov  dx, frame. re sparaO  ;get  number  of  reserved  paragraphs 
int  21h  ;call  DOS  interrupt  and  thus  end 

;the  program 


tsrinit  endp 


—  ISINST:  Determines  if  the  program  is  already  installed  - 

—  Call  from  Turbo:  function  Islnst(  IdString  :  IdsType  )  :  boolean; 

' —  Return  value:  1,  if  the  program  was  already  installed. 


7 

else  0  ' 

isinst 

proc  near 

sframel 

struc 

/structure  for  accessing  the  stack 

bpl 

dw  ? 

/stores  BP 

ret_adrl 

dw  ? 

/return  address 

idptrl 

dd  ? 

/pointer  to  the  ID  string 

sframel 

ends 

/end  of  the  structure 

frame 

equ  [  1:^  -  bpl  ] 

push  bp 

/save  BP  on  the  stack 

mov  1:^,  sp 

/transfer  Sp  to  BP 

push  ds 

/save  DS  on  the  stack 
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; —  determine  segment  address  of  the  current  int  9  handler  - 
mov  ax,3509h  ;get  interrupt  vbector  9h 


int  21h 

mov  di, offset  ld_buf 
Ids  si ,  frame .  Idpt rl 

xor  dl,dl 
mov  cl, [si] 
mov  ch,  dl 
IslO:  lodsb 

Clip  al,es:[dl] 
jne  not_inst 
Inc  dl 
loop  isiO 

mov  dl,l 

not_lnst;  mov  al,dl 
pop  ds 
pop  bp 
ret  4 

islnst  endp 


;DOS  Interrupt  gets  seg  addr  In  ES 
;ES:DI  points  to  the  installed  ID_BUF 
;DS:SI  points  to  the  ID_STRING  passed 

/return  code:  not  installed 
/get  length  of  the  string 
/high  byte  of  the  counter  to  0 
/load  character  from  string 
/compare  with  other  string 
/not  equal  — >  NOT_INST 
/lncr«nent  pointer  to  string  2 
/ccxnpare  the  next  characters 

/the  strings  are  identical 

/put  return  code  in  AL 
/get  DS  back  from  stack 
/get  BP  back  frcxn  stack 
/back  to  the  caller 

/end  of  the  procedure 


/ —  CALL_END:  calls  the  end  function  when  the  TSR  is  reinstalled  — 
/ —  Input  :  Dl  »  offset  address  of  the  routine  to  be  called 
/ —  Info  :  This  function  is  not  intended  to  be  called  by  a  Turbo 

/ —  program 

call_end  proc  far 

call  dl  /call  the  end  function 

ret  /back  to  the  caller 

call_end  endp 


/ —  UNINST:  removes  the  TSR  program  and  releases  the  allocated  - 

/ —  memory. 

/ —  Call  from  Turbo  ;  procedure  Uninst  (  EndPtr  :  word  )/  external/ 

/ —  Info  :  If  the  value  $FFFF  is  passed  as  the  address, 

/ —  then  no  end  function  will  be  called. 

/ —  Note  :  This  function  should  be  called  only  if  a  previous 

/ —  call  to  IS__INST()  returned  a  value  of  1. 

uninst  proc  near 

sframe2  struc 

hp2  dw  ? 

ret_adr2  dw  ? 

prcptr2  dw  ? 

sframe2  ends 

frame  equ  [  bp  -  bp2  ] 


push  bp 

/save  BP  on  the  stack 

mov 

bp,sp 

/transfer  SP  to  BP 

push  ds 

/save  DS  on  the  stack  ^ 

determine  seg  addr 

of  the  current  int  9h  handler  - 

mov 

ax,3509h 

/get  Interrupt  vector  9h 

int 

21h 

/DOS  interrupt  puts  seg  addr  in  ES 

mov 

dl , frame . prcptr 2 

/get  address  of  the  end  procedure 

cmp 

di,0ffffh 

/no  end  procedure  called? 

je 

no_endprc 

/NO - >  NO_ENDPRC 

/structure  for  accessing  the  stack 

/stores  BP 

/return  address 

/pointer  to  the  end  procedure 

/end  of  the  structure 
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no_endprc: 


; —  Perform  context  change  to  the  Turbo  program  and 
; —  execute  the  specified  end  procedure 


mov 

cs : ce_seg, es 

/save  ES  in  the  jump  vector 

mov 

cs:uprg_ss,ss 

/save  current  stack  segment  and  stack 

mov 

cs:uprg_sp,sp 

/pointer 

cli 

/disable  interrupts 

mov 

ss, es:t_ss 

/activate  the  stack  of  the  TSR 

mov 

sp,es:t_sp 

/program 

push 

es 

/save  ES  on  the  stack 

mov 

ah, 2f h 

/ftn.  no.:  get  DTA  address 

int 

21h 

/call  DOS  interrupt 

mov 

cs : u_dta_of s, bx 

/save  DTA  address  of  the  interrupted 

mov 

cs ; u_dta_seg, es 

/program 

pop 

es 

/get  ES  frcan  the  stack 

mov 

ah,  50h 

/ftn.  no.;  set  address  of  the  PSP 

mov 

bx,es:t  psp 

/get  segment  address  of  the  PSP 

int 

21h 

/call  DOS  interrupt 

push 

ds 

/save  ES  and  DS  on  the  stack 

push 

es 

mov 

ah, lah 

/ftn.  no.;  set  DTA  address 

mov 

dx,es:t_dta  ofs 

/get  offset  address  and  segment 

mov 

ds,es:t  dta  seg 

/address  of  the  new  DTA 

int 

21h 

/call  DOS  Interrupt 

mov 

ds,es:t_ds 

/set  segment  register  for  the  Turbo 

mov 

es,es:t_es 

/program 

call 

cs: [ce_ptr] 

/call  the  end  procedure 

; —  context  change  to  the  Turbo  program 


mov 

ah,  lah 

/ftn.  no.:  set  DTA  address 

mov 

dx,  cs:u_dta  ofs 

/load  offset  and  segment  addresses 

mov 

ds,cs;u  dta  seg 

/of  the  DTA  of  the  interrupted  program 

int 

21h 

/call  DOS  interrupt 

pop 

es 

/restore  seg  addr  of  the  Turbo  program 

pop 

ds 

/from  the  stack 

mov 

ah, 50h 

/ftn.  no.:  set  address  of  the  PSP 

mov 

bx,  cs 

/put  CS  in  BX 

sub 

bx, lOh 

/calculate  segment  address  of  the  PSP 

int 

21h 

/call  DOS  interrupt 

cli 

/disable  interrupts 

mov 

ss,  cs:uprg_ss 

/restore  stack  pointer  and  stack 

mov 

sp,  csiuprg  sp 

/ segment 

sti 

/allow  Interrupts  again 

; —  reinstall  the  Interrupt  handler  of  the  TSR  - 

; —  program  again  - 


cli 

mov  ax,2509h 
mov  ds,es:int9_seg 
mov  dx,es:int9_ofs 
int  21h 


/disable  interrupts 
;ftn.  no.:  set  handler  for  int  9 
/segment  address  of  the  old  handler 
/offset  address  of  the  old  handler 
/reinstall  the  old  handler 


mov  ax, 2513h 
mov  ds,  e  s : i nt 1 3_seg 
mov  dx,es:intl3_ofs 
int  21h 


/ftn.  no.:  set  handler  for  int  13 
/segment  address  of  the  old  handler 
/offset  address  of  the  old  handler 
/reinstall  the  old  handler 
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uninst 


mov 

ax,2528h 

/ftn.  no.  set  handler  for  int  28 

mov 

ds,es:int28_seg 

/segment  address  of  the  old  handler 

mov 

dx,es;int28  ofs 

/offset  address  of  the  old  handler 

int 

21h 

/reinstall  the  old  handler 

sti 

/allow  interrupts  again 

mov 

es,es:t_psp 

/save  seg  addr  of  the  PSP  of  the 

mov 

cx,es 

/Turbo  program  in  CX 

mov 

es,es:[  02ch  ] 

/get  seg  addr  of  environ  from  PSP 

mov 

ah,49h 

/ftn.  no.:  release  allocated  memory 

int 

21h 

/call  DOS  interrupt 

mov 

es,cx 

/restore  ES  from  CX 

mov 

ah,49h 

/ftn.  no.:  release  allocated  msnory 

int 

21h 

/call  DOS  interrupt 

pop 

ds 

/restore  DS  and  BP  fr«n  stack 

pop 

hp 

ret 

2 

/return  to  the  caller 

endp 

/end  of  the  procedure 

—  The  new  interrupt  handlers  follow  - 


; —  the  new  interrupt  09h  handler 
into 9  proc  far 


pushf  /simulate  calling  the  handler  via  the 

call  cs:int9_ptr  ;INT  9h  Instruction 


cli 

crop  cs:  recur,  0 
jne  ik_end 


/suppress  interrupts 

/is  the  TSR  program  already  active? 

/Yes,  back  to  the  caller  of  int  9 


/ —  test  to  see  if  the  BIOS  disk  int  is  being  executed 

anp  cs:in_bios,0  /BIOS  disk  interrupt  active? 

jne  ik_end  /YES  — >  abck  to  caller 


/ —  BIOS  disk  interrupt  is  not  active,  test  for  hotkey 


push  ax  /save  ES  and  AX  on  the  stack 

push  es 

xor  ax, ax  /set  ES  to  the  lowest  memory  segment 

mov  es,ax 

mov  ax,word  ptr  es: [417h]  /get  BIOS  keyboard  flag 
and  ax, cs:key_mask  /mask  out  the  non-hotkey  bits 

cmp  ax, cs:key_mask  /are  only  the  hotkey  bits  left? 

pop  es  /restore  ES  and  AX 

pop  ax 


jne  ik_end 


/hotkey  discovered?  NO  — >  return 


/ —  the  hotkey  was  pressed,  test  to  see  if  DOS  is  active  - 


push  ds 
push  bx 

Ids  bx, cs:daptr 
Clip  byte  ptr  [bx],0 
pop  bx 
pop  ds 
jne  ik_end 


/save  DS  and  BX  on  the  stack 

/DS:BX  now  point  to  the  INDOS  flag 
/DOS  function  active? 

/get  BX  and  DS  from  the  stack 

/DOS  function  active  — >  IK_END 


/ —  DOS  is  not  active,  activate  TSR  program 


call  start  tsr 


/start  the  TSR  program 
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ik_end:  iret 

lnt09  endp 

; —  the  new  interrupt  13h  handler 
lntl3  proc  far 

mov  cs : i n_bios , 1 
pushf 

call  cs:lntl3_ptr 
mov  cs;in_blos,  0 


intl3  endp 

; —  the  new  interrupt  28h  handler 
lnt28  proc  far 

pushf 

call  cs:int28_ptr 
cli 

arp  cs :  recur,  0 
je  idOl 
id  end:  iret 


;back  to  the  interrupted  program 


;set  flag  and  show  that  the  BIOS  disk 

/interrupt  is  active 

/simulate  calling  the  old  interrupt 

/handler  via  int  13h 

/BIOS  disk  interrupt  no  longer  active 

/back  to  the  caller,  but  don't  get 
/the  flag  reg  frcrni  the  stack  first 


/simulate  calling  the  old  interrupt 
/handler  via  int  28h 

/suppress  further  interrupts 

/is  the  TSR  program  already  active? 

/NO - >  IDOl 

/YES  - >  back  to  the  caller 


/ —  the  TSR  program  is  not  yet  active  - 

idOl:  cnp  cs:in_bios,  0  /is  BIOS  disk  Interrupt  active? 

jne  id__end  /YES  — >  back  to  the  caller 


/ —  BIOS  disk  interrupt  not  active,  test  for  hotkey  - 

push  ax  /save  ES  and  AX  on  the  stack 

push  es 

xor  ax, ax  /set  ES  to  the  lowest  memory  segment 

mov  es,ax 

mov  ax,word  ptr  es: [417h]  /get  BIOS  keyboard  flag 
and  ax,  cs:key_mask  /mask  out  the  non-hotkey  bits 

cmp  ax, cs : key_mask  /are  only  the  hotkey  bits  left? 

pop  es  /restore  ES  and  AX 

pop  ax 

jne  ik_end  /hotkey  discovered?  NO  — >  return 

call  start_tsr  /start  the  TSR  program 

iret  /back  to  the  interrupted  program 

lnt28  endp 


/ —  START_TSR:  activate  the  TSR  program  - 

start_tsr  proc  near 

mov  cs : recur, 1  /set  the  TSR  recursion  flag 

/ —  perform  context  change  to  the  TSR  program  - 

mov  cs:uprg_ss, ss  /save  current  stack  segment  and 

mov  cs:uprg_sp, sp  /stack  pointer 

mov  ss,cs:t_ss  /activate  the  stack  of  the 

mov  sp,cs:t_sp  /Turbo  program 

push  ax  /save  the  processor  registers  on  the 

push  bx  /turbo  stack 

push  cx 
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tsrsl: 


tsrs2: 


push  dx 
push  bp 
push  si 
push  dl 
push  ds 
push  es 

; —  save  64  words  from  the  DOS  stack 


mov 

cx,  64 

;loop  counter 

mov 

ds,cs:uprq  ss 

;set  DS;SI  to  the  end  of  the  DOS  stack 

mov 

si,cs:uprg_sp 

push  word  ptr  [si] 

/save  word  from  the  DOS  stack  on  the 

inc 

si 

;C  stack  and  set  SI  to  the  next  word 

inc 

si 

loop  tsrsl 

/process  all  64  words 

mov 

ah, 51h 

/ftn.  no.:  get  addr  of  the  PSP 

int 

21h 

/call  DOS  interrupt 

mov 

cs : u_psp, bx 

/save  seg  addr  of  the  PSP 

mov 

ah,2fh 

/ftn.  no.:  get  DTA  address 

int 

21h 

/call  DOS  interrupt 

mov 

cs:u  dta  ofs,bx 

/save  address  of  the  DTA  of  the 

mov 

cs : u_dta_seg, es 

/interrupted  program 

mov 

ah,50h 

/ftn.  no.:  set  address  of  the  PSP 

mov 

bx,cs:t  psp 

/get  seg  addr  of  the  Turbo  prg  PSP 

int 

21h 

/call  DOS  interrupt 

mov 

ah,  lah 

/ftn.  no.:  set  DTA  address 

mov 

dx,cs:t  dta  ofs 

/get  offset  address  of  the  new  DTA 

mov 

ds,cs:t  dta  seg 

/and  segment  address  of  the  new  DTA 

int 

21h 

/call  DOS  Interrupt 

mov 

ds,  cs:t_ds 

/set  segment  register  for  the 

mov 

es,  cs:t_es 

/Turbo  program 

sti 

/allow  interrupts  again 

call 

cs;prc  adr 

/call  the  start  function 

cli 

/disable  interrupts 

perform  context  change  to  the  interrupted  program  - 

mov 

ah, lah 

/ftn.  no.:  set  DTA  address 

mov 

dx, cs:u  dta  ofs 

/load  offset  and  segment  addresses 

mov 

ds,cs:u  dta  seg 

/of  the  interrupted  program's  DTA 

int 

21h 

/call  DOS  interrupt 

mov 

ah, 50h 

/ftn.  no.:  set  address  of  the  PSP 

mov 

bx,cs;u_psp 

/seg  addr  of  the  interrupted  prg's  PSP 

int 

21h 

/call  DOS  interrupt 

restore  DOS  stack  again  - 

mov 

cx,  64 

/loop  counter 

mov 

ds,cs:uprg  ss 

/load  DS:SI  with  the  end  address  of 

mov 

si,cs:uprg  sp 

/the  DOS  stack 

add 

si, 128 

/set  SI  to  the  start  of  the  DOS  stack 

dec 

si 

/Si  to  the  previous  stack  word 

dec 

si 

pop 

word  ptr  [si] 

/words  from  Turbo  stack  to  DOS  stack 

loop 

tsrs2 

/process  all  64  words 

pop 

es 

/restore  the  saved  registers  frcxn  the 

pop 

ds 

/Turbo  stack 

pop 

di 

pop 

si 
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pop 

bp 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

mov 

ss,  cs:uprg_ss 

;set  stack  pointer  and  segment 

mov 

sp,  cs:uprg_sp 

;of  the  interrupted  program 

mov 

cs :  recur,  0 

;resset  TSR  recursion  flag 

ret 

;back  to  the  caller 

start_tsr  endp 


CCX)E  ends 

end 


;end  of  the  code  segment 
;end  of  the  program 
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Sound  on  the  PC 


Every  PC  has  a  built  in  speaker  which  beeps  when  some  errors  occur,  or  when  the 
keyboard  buffer  is  full.  The  speaker  can  also  generate  other  sounds.  This  ch^ter 
demonstrates  sound  generation  through  software. 

How  the  PC  generates  sound 

Tones  occur  when  the  cone  of  a  speaker  oscillates  (moves  back  and  forth).  A  single 
oscillation  creates  a  click  instead  of  a  musical  sound.  If  a  group  of  oscillations 
sounds  in  rapid  succession,  a  tone  occurs.  The  pitch  (the  note  value)  of  a  tone 
depends  on  the  number  of  cycles  (oscillations)  that  occur  per  second.  The  pitch  of  a 
tone  in  cycles  per  second  is  measured  in  Hertz.  For  example,  if  the  speaker 
oscillates  at  a  rate  of  440  times  per  second,  it  generates  a  tone  with  a  frequency  of 
440  Hertz.  Certain  pitches  have  specific  note  names  assigned  to  them,  such  as 
A440  (the  note  that  sounds  at  440  Hertz).  The  following  table  shows  the  pitches 
and  frequencies  of  tones  generated  by  the  PC.  This  range  covers  8  octaves  (almost 
the  range  of  a  full  piano  keyboard): 


1  Octave 

' 

1 

2 

_ 3 _ 1 

C 

16.35 

C 

32.70 

c 

65.41 

c 

130.81 

K9 

17.32 

c# 

34.65 

B9 

c# 

138.59 

D 

D 

36.71 

D 

73.42 

D 

146.83 

■31 

19.45 

38.89 

■39 

77.78 

■39 

155.56 

E 

20.60 

E 

41.20 

E 

82.41 

E 

164.81 

F 

21.83 

F 

43.65 

F 

87.31 

F 

174.61 

■33 

■SB9 

F# 

46.25 

F# 

92.50 

F# 

185.00 

G 

49.00 

G 

G 

196.00 

^B3 

Bsa 

G# 

51.91 

B9 

103.83 

G# 

207.65 

A 

27.50 

A 

55.00 

A 

110.00 

A 

220.00 

B9 

29.14 

A# 

58.27 

A# 

116.54 

A# 

233.08 

30.87 

B 

61.74 

B 

123.47 

B 

246.94 
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1  Octave 

4 

5 

6 

7  1 

C 

261.63 

c 

523.25 

c 

1046.50 

C 

2093.00 

C# 

277.18 

c# 

554.37 

c# 

1108.74 

c# 

2217.46 

D 

293.66 

D 

587.33 

D 

1174.66 

D 

2349.32 

D# 

311.13 

D# 

622.25 

D# 

1244.51 

D# 

2489.02 

E 

329.63 

E 

659.26 

E 

1328.51 

E 

2637.02 

F 

349.23 

F 

698.46 

F 

1396.91 

F 

2793.83 

F# 

369.99 

F# 

739.99 

F# 

1479.98 

F# 

2959.96 

G 

392.00 

G 

783.99 

G 

1567.98 

G 

3135.96 

G# 

415.30 

G# 

830.61 

G# 

1661.22 

G# 

3322.44 

A 

440.00 

A 

880.00 

A 

1760.00 

A 

3520.00 

A# 

466.16 

A# 

923.33 

A# 

1864.66 

A# 

3729.31 

B 

493.88 

B 

987.77 

B 

1975.53 

B 

3951.07 

The  speaker  in  the  PC  can  generate  frequencies  from  1  Hertz  up  to  more  than 
1,000,000  Hertz.  However,  most  human  ears  are  only  capable  of  hearing 
frequencies  between  20  and  20,000  Hertz.  In  addition,  PC  speakers  don’t  reproduce 
music  very  well  since  they  play  some  tones  louder  than  others.  Since  the  speaker 
has  no  volume  control,  this  effect  cannot  be  changed. 

A  sound  program  should  oscillate  the  speaker  according  to  the  frequency  of  the 
tones  desired.  Here  is  a  rough  outline  of  a  possible  sound  generation  program: 

•  Invoke  the  instruction  to  move  the  cone  forward,  then  undo  the  instruc¬ 
tion  (move  the  cone  back  to  its  original  position).  Repeat  these  steps  in  a 
loop  so  that  it  occurs  as  many  times  per  second  as  required  by  the 
frequency  of  the  tone  being  generated. 

The  above  procedure  has  several  disadvantages: 

•  The  execution  speed  of  individual  instructions  depends  on  the  processing 
speed  of  the  computer. 

•  This  program  must  be  adjusted  to  the  processing  speed  of  individual 
computers. 

•  The  tone  becomes  distorted  when  the  tone  production  loop  ends. 


8253  timer 

Every  PC  uses  one  particular  chip  for  tone  generation:  The  8253  programmable 
timer,  which  actually  maintains  control  of  the  internal  clock.  The  8253  can 
perform  both  timing  and  sound  thanks  to  its  ability  to  enable  a  certain  action  at  a 
certain  point  in  time.  It  senses  timing  from  oscillations  it  receives  from  the  PC's 
8284  oscillator,  which  generates  1,193,180  impulses  per  second.  The  8253  can 
then  be  instructed  how  many  of  these  impulses  it  should  wait  before  triggering  a 
certain  action.  In  the  case  of  tone  generation,  this  action  consists  of  sending  an 
impulse  to  the  speaker.  Before  executing  this  action,  the  chip  must  be  programmed 
for  the  particular  frequency  it  should  generate.  The  frequency  must  be  converted 
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from  cycles  per  second  into  the  number  of  oscillations  coming  from  the  oscillator. 
This  is  done  with  the  help  of  the  following  formula: 

counter  =  1,193,180  /  frequency 

The  result  of  this  formula,  the  variable  counts,  passes  to  the  chip.  As  the  formula 
demonstrates,  the  result  for  a  high  frequency  is  relatively  low,  and  the  result  for  a 
low  frequency  is  relatively  high.  This  makes  sense,  since  it  tells  the  8253  chip 
how  many  of  the  1,193,180  cycles  per  second  it  must  wait  until  it  can  send 
another  signal  to  the  speaker.  The  low^  the  value,  the  more  often  it  sends  a  signal 
to  move  the  speaker  cone  back  and  forth,  causing  a  higher  tone. 

Ports  and  PC  sound 

Communication  between  the  CPU  and  the  8253  occurs  through  ports.  First  the 
value  182  is  sent  to  port  43H.  This  instructs  the  8253  that  it  should  start 
generating  a  signal  as  soon  as  the  interval  between  individual  signals  has  been 
passed.  This  interval  is  the  value  which  was  calculated  with  the  formula  above. 
Since  the  8253  stores  this  value  internally  as  a  16-bit  number  (a  value  between  0 
and  65,535),  it  limits  the  range  of  tones  generated  to  frequencies  between  18  and 
1,193,180  Hertz.  This  number  must  be  transmitted  to  port  42H.  Since  this  is  an 
8-bit  port,  the  16  bits  of  this  number  cannot  be  transmitted  simultaneously.  First 
the  least  significant  eight  bits  are  transmitted,  then  the  most  significant  eight  bits 
are  transmitted. 

Now  the  second  step  occurs — the  8253  signal  is  sent  to  the  speaker.  The  speaker 
access  occurs  through  port  61H,  which  is  connected  to  a  programmable  peripheral 
chip.  The  two  lowest  bits  of  this  port  must  be  set  to  1  to  transmit  the  8253  signal 
to  the  speaker.  Since  the  remaining  six  bits  are  used  for  other  purposes,  they 
cannot  be  changed.  For  this  reason,  the  contents  of  port  61H  must  be  read,  the 
lowest  two  bits  must  be  set  to  1  (an  OR  combination  with  3)  and  the  resulting 
value  must  be  returned  to  port  61H.  A  tone  sounds,  which  ends  only  when  the  bits 
just  set  to  1  are  reset  again  to  0. 
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Octave  3  Octave  4 


Octave  5 


CDEFGAB  CDEFGAB 


CD  E  F  G  A  B 


C  =  9121 

F#=  6449 

C  =  4560 

F#=  3224 

C  =  2280 

F#=  1612 

C#=  8609 

G  =  6087 

C#=  4304 

G  =  3043 

C#=  2152 

G  =  1521 

D  =  8126 

G#=  5746 

D  =  4063 

G#=  2873 

D  =  2031 

G#=  1436 

D#=  7670 

A  =  5423 

D#=  3834 

A  =  2711 

D#=  1917 

A  =  1355 

E  =  7239 

A#=  5119 

E  =  3619 

A#=  2559 

E  =  1809 

A#=  1292 

F  =  6833 

B  =  4831 

F  =  3416 

B  =  2415 

F  =  1715 

B  =  1207 

Keyboard  setup  and  timer  frequencies 


Demonstration  programs 

GW-BASIC  and  Turbo  Pascal  have  resident  sound  commands.  The  machine 
language  programmer  and  C  programmer  must  create  their  own  sound  applications. 

Demonstration  programs  follow  for  both  these  languages.  They  can  be  added  to 
your  own  C  or  assembly  language  programs. 

How  they  work 

Both  programs  produce  tones  for  specific  time  periods.  This  is  done  with  the  help 
of  the  timer  interrupt  ICH  which  is  called  by  the  timer  interrupt  8H  18.2  times 
per  second.  When  the  tone  generation  routine  executes,  it  receives  the  frequency  of 
the  tone  and  the  tone's  duration  (length).  The  duration  is  measured  in  18ths  of  a 
second,  so  the  value  18  corresponds  to  a  second  and  the  value  9  corresponds  to  a 
half-second.  This  value  is  stoed  in  a  variable. 

Immediately  before  activating  the  tone  output,  the  interrupt  routine  of  interrupt 
ICH  turns  to  a  user-defined  routine.  This  routine,  called  18.2  times  per  second, 
decrements  the  tone  duration  in  the  variable  during  every  call.  When  it  reaches  the 
value,  the  tone  duration  ends  and  the  tone  must  be  switched  off.  The  routine 
allocates  a  variable  to  notify  the  actual  sound  routine  of  this  end.  The  sound 
routine  recognizes  this  imme^ately,  since  it  has  been  in  a  constant  wait  loop  since 
switching  on  the  tone.  All  this  loop  does  is  monitor  the  contents  of  this  variable. 
After  recognizing  the  end  of  the  tone,  it  stops  the  sound  output  and  returns  the 
timer  interrupt  to  its  old  routine. 


450 


Abacus 


9.  Sound  on  the  PC 


The  sound  routine  requires  the  number  assigned  to  this  tone,  rather  than  the 
frequency  itself.  This  number  is  related  to  the  table  containing  the  frequencies  of 
octaves  3  to  5.  The  value  0  stands  for  C  (tf  the  third  octave.  1  stands  for  C-sharp,  2 
frv  D,  3  for  D-sharp,  etc. 

Note:  Both  the  C  program  and  assembly  language  ixogram  demonstrate  the 

sound  routine  by  playing  a  scale  over  the  course  of  two  octaves,  with 
each  note  soun^ng  for  a  half  a  second  each.  The  machine  language 
demo  program  and  sound  routine  are  stored  in  one  frle.  The  C 
versions  of  these  programs  are  split  into  two  source  code  files.  The  C 
demo  jHogram  contains  the  sound  function  call  only,  and  the  machine 
language  program  which  creates  the  sound  must  be  linked  to  the 
demonstration  program. 

Assembler  listing:  SOUNDA.ASM 


*****************************  It  *********************************** -k-k  ***  • 


•  * 

S  0  U  N  D  A 

★  • 

•  * 

Task  : 

Plays  a  scale  between  octaves  3  and  5  of  the 

★  • 

•  * 

PC's  musical  range.  This  routine  can  be  used 

*  ■ 

■  * 

for  other  applications 

★  • 

•  * 

Author  : 

MICHAEL  TISCHER 

*  • 

•  * 

Developed  on  : 

08/06/1987 

*  ■ 

•  * 

Last  update  : 

05/26/89 

*  • 

•  * 

Assembly  : 

MASM  SOUNDA/ 

•  * 

LINK  SOUNDA/ 

★  • 

.  * 

•  w___ 

EXE2BIN  SOUNDA  SOUNDA. CC»! 

*  . 

• 

•  * 

Call  from  DOS  : 

SOUNDA 

★  • 
f 

************************************ *k* ******************************** • 

code 

segment  para 

'CODE'  /Definition  of  CODE  segments 

org  lOOh  ; Starts  at  address  lOOH 

; directly  following  PSP 

assume  cs:code,  ds:code,  esrcode,  ss:code 


sound  proc  near 

; —  Display  message 


mov  ah, 9  ;Function  number  for  displaying  string 

mov  dx, offset  initm  ; String's  offset  address 

int  21h  ;Call  DOS  interrupt  21H 


; —  Play  scale  — 


xor  bl,bl 
mov  dl,9 

nextune:  call  play_tune 
inc  bl 
cmp  bl,36 
jne  nextune 


/Start  at  C  of  octave  3 
;for  duration  of  1/2  second 
;Play  note 
/Next  note 

/All  notes  in  this  octave  played? 
/NO  — >  Play  next  note 


/ —  Display  end  message  - 


mov  ah, 9 
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sound 


moV 

dx, offset  endmes 

Int 

21h 

mov 

ax, 4C00h 

Int 

21h 

endp 

; String's  offset  address 
;Call  DOS  Interrupt  21H 

; Program  ends  when  call  to  a  DOS 
; function  results  In  an  error  code 
;of  0 


Main  program  data 


Inltm  db  13, 10, "SOUND  (c)  1987  by  Michael  Tlscher",13,10,13,10 

db  "Your  PC  should  now  be  playing  a  chromatic  scale  In  the" 
db  "3rd  and  5th  ",  13, 10, "octaves  of  Its  range.  If  " 

db  "your  PC  speaker  works. ",13,10,"$" 

endmes  db  13, 10, "End", 13, 10,"$" 


--  PLAY_TUNE:  Play  a  note  - 

—  Input  :  BL  *  Note  number  (relative  to  C  of  the  3rd  octave) 

DL  -  Duration  of  note  In  1/18  second  Increments 

—  Output  :  none 

—  Register  ;  AX,  CX,  ES  and  FLAGS  are  changed 

—  Info  :  Immediately  after  the  tones,  control  returns  to  the 

calling  routine 


play: 


proc 

near 

push 

dx 

push 

bx 

/ —  Adapt  timer  Inter: 

push  dx 

push  bx 

mov 

ax,351ch 

Int 

21h 

mov 

old_tlme,bx 

mov 

old_tlme+2,es 

mov 

dx,  offset  sound_ 

mov 

ax, 251ch 

Int 

21h 

pop 

bx 

pop 

dx 

mov 

al,182 

out 

43h,al 

xor 

bh,  bh 

shl 

bx,  1 

mov 

ax, [note+bx] 

out 

42h,al 

mov 

al,ah 

out 

42h,al 

In 

al,61h 

or 

al,llb 

mov 

s_ende, 1 

mov 

s  counter, dl 

out 

61h,al 

cmp 

s_ende,  0 

jne 

play 

In 

al,61h 

and 

al,  11111100b 

out 

61h,al 

;Push  DX  and  BX  onto  the  stack 


;Push  DX  and  BX  onto  stack 

;Get  address  of  time  Interrupt 
;Call  DOS  Interrupt 
; Offset  address  of  old  Interrupt 
;and  note  segment  address 


;Set  new  timer  routine 

;Call  DOS  Interrupt 

;Pop  BX  and  DX  off  of  stack 


/Prepare  to  play  note 
/Send  value  to  time  command  register 
/BH  for  addressing  note  table  *  0 
/Double  note  number  (fr.  word  table) 
/Get  tone  value 

/LO-byte  on  timer  counter  register 
/Transfer  Hl-byte  to  AL 
/and  to  timer  counter  register 
/Read  speaker  control  bit 
/Lowest  two  bits  enable  speaker 
/Note  still  has  to  be  played 
/Play  note  for  duration 
/Disable  speaker 

/Note  finished? 

/N)  — >  Walt 

/Read  speaker  control  bit 
/Clear  lowest  two  bits 
/Disable  speaker 


/ —  Reactivate  old  timer  Interrupt  - 


mov  cx,ds 
mov  ax,251ch 


/Note  DS 

/Set  function  no.  for  Intrrpt  vector 
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Ids  dx,dword  ptr  old_tlme  ;Load  old  address  into  DS:DX 


int  21h 
mov  ds, cx 

pop  bx 
pop  dx 
ret 

play_tune  endp 
; —  new  timer  interrupt 


/Call  DOS  interrupt 
/Return  DS 

/Pop  BX  and  DX  off  of  stack 
/Return  to  calling  program 


sound_tl 

proc 

far 

/Call  18  times  per  second 

dec 

cs :  s__counter 

/Decrement  counter 

jne 

st_ende 

/If  still  >0,  end 

mov 

cs:s_ende,0 

/Signal  note  end 

st_ende: 

jmp 

dword  ptr  cs: 

[old_time]  /Goto  old  timer  interrupt 

sound_ti 

endp 

, 

/==  Variable  set  needed  by  the  routines 

old_time 

dw  ( 

?)r  (?) 

/Address  of  old  timer  interrupt 

s_counter 

db  (?) 

/counter  for  note  duration  in  1/18 

/second  Increments 

s_ende 

db  (?) 

/Displays  whether  note  already  played 

dw  9121,8609,8126,7670 
dw  7239,6833,6449,6087 
dw  5746,5423,5119,4831 
dw  4560,4304,4063,3834 
dw  3619,3416,3224,3043 
dw  2873,2711,2559,2415 
dw  2280,2152,2031,1917 
dw  1809,1715,1612,1521 
dw  1436,1355,1292,1207 


Note  values  for  octave  3 


/Note  values  for  octave  4 


/Note  values  for  octave  5 


End 


code 


ends 

end  sound 


/End  of  CODE  segment 

/End  of  the  Assembler-Program 


Here's  the  C  program  to  call  the  sound  function  and  the  assembly  language  listing 
of  the  C  sound  function. 


C  listing:  SOUNDC.C 

/********************************************************************** / 


/*  S  0  U  N  D  C  */ 

/*  Task  ;  Plays  a  scale  between  octaves  3  and  5  of  the  */ 
/*  PC  musical  range,  using  an  assembler  function  */ 

/*  Author  :  MICHAEL  TISCHER  */ 
/*  Developed  on  :  08/15/1987  */ 
/*  Last  update  :  05/26/1989  */ 

/*  (MICROSOFT  C)  */ 
/*  Creation  :  CL  /AS  SOUNDC.C  */ 
/*  LINK  SOUNDC  SOUNDCA/  */ 
/*  Call  :  SOUNDC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 
/*  Creation  :  Create  a  project  file  listing  the  following:  */ 
/*  soundc  */ 
/*  soundca.obj  */ 
/*  Options  :  Before  compiling  and  linking,  select  the  */ 
/*  Options  menu  and  Linker  option.  Under  the  */ 
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/*  Linker  options  menu,  make  sure  that  the  */ 

/*  Case  sensitive  link  option  is  set  to  Off  */ 

/★*************★******************★*********************★**************/ 

/*==  Function  declaration  from  the  assembler  module  —— —»—*«=*=*/ 

extern  void  Sound ();  /*  Add  the  external  assembler  routine  */ 

/**★*********★★★*★*★*★*★*****★★********★********* ******* ******** *******/ 

/**  MAIN  PROGRAM  **/ 

/**********************************************************************/ 

void  mainO 

{ 

int  Note; 

printf (“NnSOUND  (c)  1987  by  Michael  Tischer\n\n-) ; 

printf  (’•Your  PC  should  now  be  playing  a  musical  scale  in  the  3rd  &  "); 
printfC*  5th  octaves  ofXnlts  range.  If  you  aren't  hearing  the  notes"); 
printf ("  your  PC's  speaker  may  be  damaged. \n\n" ) ; 

for  (Note  =  0;  Note  <  35;  Sound (Note++,  9))  /*  Play  a  note  once  each  */ 

;  /*  1/2  second  */ 

printf ("End\n") ; 

} 

Assembler  listing:  SOUNDCA.ASM 


********************************************************************** 


* 

S  0  U  N  D  C  A 

* 

_* 

* 

Task 

:  Creates  a  function  suitable 

for  inclusion 

in 

r 

*; 

* 

C  codes,  which  enables  C  to 

play  notes  in 

the 

* 

* 

it _ 

3rd,  4th  and  5th  PC  musical 

octave 

* 

_* 

* 

Author 

:  MICHAEL  TISCHER 

f 

★  . 

* 

Developed  on 

:  08/15/1987 

★  • 
f 

* 

*__ 

Last  update 

:  05/26/1989 

★  • 
f 

• 

* 

assembly 

:  MASM  SOUNDCA; 

★  • 

********************************************************************** 


IGROUP  group  _text  ;Merging  of  program  segment 

DGROUP  group  const, _bss,  _data  ;Merging  of  data  segment 
assume  CS: IGROUP,  DS: DGROUP,  ES: DGROUP,  SS: DGROUP 

public  _Sound  ;Make  function  public  (accessible  to 

; other  programs) 

CONST  segment  word  public  'CONST'; This  segment  denotes  all  read-only 
CONST  ends  ; constants 

_BSS  segment  word  public  'BSS'  ;Thls  segment  denotes  all  static,  non- 

_BSS  ends  ; initialized  variables 

_DATA  segment  word  public  'DATA'  ;This  segment  contains  all  initialized 

;global  and  static  varlbles 

old_time  dw  (?) ,  (?)  ;Address  of  old  timer  interrupt 

s_counter  db  (?)  ;Counts  duration  of  notes  in 

;1/18  second  increments 

s_endit  db  (?)  ; Indicates  whether  note  already  played 

tones  dw  9121,8609,8126,7670  ;Note  values  for  octave  3 
dw  7239,6833,6449,6087 
dw  5746,5423,5119,4831 

dw  4560,4304,4063,3834  ;Note  values  for  octave  4 
dw  3619,3416,3224,3043 
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dw  2873,2711,2559,2415 

dw  2280,2152,2031,1917  ;Note  values  for  octave  5 
dw  1809,1715,1612,1521 
dw  1436,1355,1292,1207 

_DATA  ends 

;  =  Program 

_TEXT  segment  byte  public  •€(»£'  ;  Program  msegment 

; —  SOUND:  Plays  a  note  - 

/ —  Call  from  C  :  Sound ((Int)  Note,  (int>  Duration); 

; —  Output  :  none 

; —  Info  :  Note  is  the  number  of  the  note  relative  to  3rd  octave 

C 

; —  Duration=duration  of  the  note  in  1/18-sec.  increments 

_Sound  proc  near 


push  bp 

/Push  BP  onto  stack 

mov 

bp,sp 

/Transfer  SP  to  BP 

;  — 

^fodify  timer  interrupt  for  user  application  - 

mov 

word  ptr  cs:setds+l,ds  /Store  DS  for  new  timer  interrupt 

mov 

ax,351ch 

/Get  timer  interrupt *s  address 

int 

21h 

/Call  DOS  interrupt 

mov 

old  time,bx 

/Note  offset  address  and  segment 

mov 

old  time+2,es 

/address  of  old  interrupt 

mov 

word  ptr  cs:st junp+l,bx  /Save  for  new  timer  interrupt 

mov 

word  ptr  cs:st jump+3,es  ; 

mov 

bx,ds 

/Place  DS  in  BX 

push  cs 

/Push  CS  onto  stack 

pop 

ds 

/and  pop  off  DS 

mov 

dx, offset  sound 

ti  /Offset  address  of  new  timer  routine 

mov 

ax,251ch 

/Set  new  timer  routine 

int 

21h 

/Call  DOS  interrupt 

mov 

ds,bx 

/Restore  DS 

mov 

al,182 

/Get  ready  to  generate  tone 

out 

43h,al 

/Send  value  to  timer  ccmmand  register 

mov 

bx, [bp+41 

/Get  note 

xor 

bh,bh 

;BH  for  addressing  of  note  table  =  0 

shl 

bx,l 

/Divide  note  number  (for  word  table) 

mov 

ax, [tones+bx] 

/Get  note  value 

out 

42h,al 

/Pass  low  byte  to  timer  counter  register 

mov 

al,ah 

/Pass  high  byte  to  AL 

out 

42h, al 

/and  to  timer  counter  register 

in 

al,61h 

/Read  speaker  control  bit 

or 

al,llb 

/Two  lowest  bits  activate  speaker 

mov 

s  endit,l 

/Still  have  to  play  note 

mov 

dl, [bp+6] 

/Get  note  duration 

mov 

s  counter,  dl 

/and  store  it 

out 

61h,al 

/Turn  on  speaker 

cmp 

s  endit,0 

/Note  ended? 

jne 

play 

/NO  — >  wait 

in 

al,61h 

/Read  speaker  control  bit 

and 

al, 11111100b 

/Clear  two  lowest  bits  to 

out 

61h,al 

/disable  speaker 

re-act i vat e  original  timer  interrupt  - 

mov 

cx,ds 

/Note  DS 

mov 

ax, 251ch 

/Set  function  no.  for  interrupt  vector 

Ids 

dx,dword  ptr  old 

time  /Load  old  address  into  DS:DX 

int 

21h 

/Call  DOS  interrupt 

mov 

ds,cx 

/Return  DS 
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mov  sp, bp 

; Restore  stack  pointer 

pop  bp 

;Pop  BP  off  of  stack 

ret 

/Return  to  calling  program 

_Sound 

endp 

; —  new  timer  interrupt  - 


sound__ti 

proc 

far 

/Call  this  18  times  per  second 

push 

ax 

/Push  AX  and  DS  onto  stack 

push 

ds 

setds: 

mov 

ax, OOOOh 

/Transfer  C  to  DS 

mov 

ds,ax 

dec 

s_counter 

/Decrememt  time  counter 

jne 

st_endit 

/If  still  unequal  to  0  then  end 

mov 

s_endit,0 

/Signal  end  of  note  duration 

st_endit ; 

:  pop 

ds 

/Pop  value  off  of  DS  (reset  to  old  value) 

pop 

ax 

/Get  AX  frcxti  stack  again 

St  juitp: 

db 

0EAh,0,0,0,0 

/FAR- JUMP  to  old  timer  interrupt 

sound_ti 

endp 

Jiext 

ends 

/End  of  program  segment 

end 

/End  of  assembler  source 
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This  chapter  explains  methods  of  programming  the  most  popular  video  cards  on 
the  PC  market.  Even  Uiough  the  video  cards  mention^  here  differ  in  their 
capabilities,  they  are  all  based  on  the  same  basic  principle.  High  level  languages 
such  as  BASIC,  Pascal  or  C  often  have  their  own  specific  keywords  and  commands 
for  controlling  screen  display.  However,  many  of  these  commands  merely  call 
BIOS  or  DOS  functions,  which  are  both  slow  and  inflexible  in  execution. 

Direct  access 

Direct  access  to  the  video  card  is  the  alternative.  Applications  from  Lotus  1-2-3® 
to  dBASE®  use  direct  video  access  coding,  to  guarantee  both  speed  and  that 
element  of  extra  control  over  the  video  display.  The  main  disadvantage: 
Programming  in  assembly  language  is  required,  since  the  communication  here 
occurs  at  the  system  level.  This  chapter  examines  the  programming  needed  for  the 
best  known  video  cards  on  the  market* 

•  Monochrome  Display  Adapter  (MDA),  also  called  a  monochrome  card 

•  Color  Graphics  Adapter  (CGA),  also  called  a  color  card 

•  Hercules  Graphic  Card  (HGC) 

•  Enhanced  Graphic  Adapter  (EGA) 

•  VideoGr^hics  Array  (VGA) 

Most  of  the  graphic  cards  on  the  market  are  compatible  with  one  of  the  cards 
mentioned  in  this  chapter,  and  the  descriptions  stated  here  should  apply  to  those 
cards. 
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Video  Graphics  Array  (VGA) 

This  also  applies  to  the  newest  gen^ation  of  video  cards,  the  VGA  card.  Designed 
in  conjunction  with  the  IBM  PS/2  system,  the  VGA  card  is  now  available  to  the 
general  public  as  an  add-on  card.  This  chapter  demonstrates  some  general  features 
of  the  EGA  and  VGA,  as  well  as  a  few  programming  techniques. 

What*s  needed 

Before  a  video  card  can  display  a  character  or  graphic  pixel  on  a  monitor  screen  or 
CRT  (cathode  ray  tube)*  the  card  must  know  the  following: 

•  which  character  or  graphic  pixel  to  display 

•  The  color  of  the  character  or  pixel 

•  The  location  on  the  screen  at  which  it  should  be  displayed. 

PC  video  cards  include  RAM  which  collects  information  about  every  CRT  screen 
pixel  or  screen  location.  This  RAM  memory  is  called  video  RAM  and  interfaces 
with  the  PC’s  RAM,  allowing  direct  access  from  the  microprocessor. 


Speed 


Rapid  screen  changes  are  important  in  word  processing  programs  and  other  PC 
applications.  For  example,  if  you  are  paging  through  a  word  processing  document 
at  high  speed,  a  25-line,  80-column  screen  requires  the  transmission  of  2,000 
characters  through  the  video  card  at  one  time.  Fast  data  transfer  is  even  more 
important  for  high-resolution  graphics.  For  example,  the  200x640-pixel  IBM 
Color  Graphics  Adapter  transmits  128,(XX)  pixels  of  graphic  information  at  a  time. 

Display  modes 

Each  type  of  video  card  can  have  more  than  one  display  mode.  Text  and  gr^hics 
display  may  be  very  different  from  one  another.  The  monitor  cannot  distinguish 
between  the  two  modes;  it  just  processes  the  graphic  information  sent  by  the  video 
card  (or  video  controller).  Fa*  the  programmer  and  the  video  card,  the  modes  require 
completely  different  programming  techniques. 

Graphic  mode  and  text  mode 

Graphic  mode  stores  the  color  of  a  screen  pixel  in  one  or  more  bits,  then  transmits 
the  contents  of  video  RAM  more  or  less  directly  to  the  screen.  Text  mode  uses  a 
different  method.  The  ASCII  code  of  a  character  is  stored  in  video  RAM  for  each 
screen  location.  When  the  video  controller  displays  the  screen,  it  obtains  the 
character  pattern  of  the  ASCII  code  from  the  ROM  chip  on  the  video  card,  then 
converts  the  code  into  a  character  matrix  of  pixels.  This  pattern  then  passes  to  the 
monitor  and  appears  on  the  screen. 
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PC  text  mode  uses  the  256-character  extended  character  set  (see  Appendix  I).  Since 
these  characters  are  numbered  sequentially  from  0  to  255,  one  byte  is  enough  for 
each  screen  position  to  display  the  character  at  the  proper  position. 

Attribute  bytes 

Every  screen  position  has  an  attribute  byte  which  indicates  the  color  or  display 
attribute  of  the  character  (underlined,  blinking,  inverse  video,  etc.).  This  means 
that  two  bytes  are  needed  for  each  position  on  the  screen.  Therefore,  a  total  of  4000 
bytes  are  required  for  a  25-line,  80-column  screen.  This  appears  to  be  a  lot  of 
memory  at  first  glance,  but  is  fairly  small  when  compared  to  the  memory 
requirements  for  bit-mapped  graphic  screen.  In  graphic  mode,  each  dot  is 
represented  by  one  or  more  bits.  A  resolution  of  640x200  pixels  requires  128,000 
bits  (16K). 

Another  advantage  of  text  mode  is  the  simplicity  in  exchanging  one  character  for 
another  on  the  screen.  The  bit-map  mode  has  its  own  advantages.  Besides  graphic 
displays,  text  can  be  displayed  as  individual  dots  whose  pattern  is  derived  from  a 
character  table  in  RAM  installed  by  the  user.  This  means  that  the  user  can  design 
his  own  fonts  (character  sets). 
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10.1  Anatomy  of  a  Video  Card 

The  figure  below  shows  the  individual  hardware  components  of  a  video  card.  The 
starting  point  for  creating  the  picture  is  always  the  video  RAM.  This  video  RAM 
contains  information  about  the  characters  to  be  displayed,  and  their  display 
attributes  (color,  style,  etc.). 

Getting  to  the  screen 

The  character  generator  first  accesses  video  RAM,  reading  the  characters  one  by 
one,  and  uses  a  character  pattern  table  to  construct  the  bit-map  that  will  later  form 
the  character  on  the  screen.  The  attribute  controller  also  gets  information  about  the 
display  attributes  (color,  underlining,  reverse,  etc.)  of  the  character  from  the  video 
RAM.  Both  modules  prepare  this  information  and  send  it  to  the  signal  controller, 
which  converts  it  to  appropriate  signals  to  be  sent  to  the  monitor.  The  signal 
controller  itself  is  controlled  by  the  CRT  controller,  which  is  the  central  point  of 
video  card  operations.  Besides  the  monitor  and  the  video  RAM,  this  CRT 
controller  is  one  of  the  most  important  components  of  a  video  system.  We  will 
examine  all  these  components  in  greater  detail. 


Block  diagram  of  a  video  card 


The  monitor 

The  monitor  is  the  device  on  which  the  video  data  is  displayed.  Unlike  the  video 
card,  the  monitor  is  a  "dumb"  device.  This  means  it  has  no  memory  and  cannot  be 
programmed.  All  monitors  used  with  PCs  are  raster-scan  devices,  in  which  the 
picture  is  made  up  of  many  small  dots  arranged  in  a  rectangular  pattern  or  raster. 
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is  done  by  switching  on  the  electron  beam  as  it  passes  over  this  dot,  causing  a 
phosphor  particle  on  the  picture  tube  to  light  up. 

Color  monitors 

While  monochrome  monitors  need  only  one  electron  beam  to  create  a  picture, 
color  monitors  use  three  beams  which  scan  the  screen  simultaneously.  Here  a 
screen  pixel  consists  of  three  phosphor  particles  in  the  basic  colors  of  light:  red, 
green,  and  blue.  Each  color  has  a  matching  electron  beam.  Any  color  in  the 
spectrum  can  be  created  by  combining  these  three  colors  and  varying  their 
intensities. 

But  since  an  ionized  phosphor  particle  emits  light  for  only  a  very  brief  period  of 
time,  the  entire  screen  must  be  scanned  many  times  per  second  to  create  the 
illusion  of  a  stationary  picture.  PC  monitors  perform  tliis  task  between  50  and  70 
times  per  second.  This  repeated  re-scanning  is  called  the  refresh  rate.  One  rule  of 
thumb  for  this  rate:  The  faster  the  refresh  rate,  the  better  quality  the  picture. 

Each  new  screen  image  begins  in  the  upper  left  comer  of  the  screen.  From  there 
the  electron  beam  moves  to  the  right  along  the  first  raster  line.  When  it  reaches  the 
end  of  this  line,  the  electron  beam  moves  back  to  the  start  of  the  next  line  down, 
similar  to  pressing  the  <Return>  key  on  a  typewriter.  The  electron  beam  then 
scans  the  second  raster  line,  at  the  end  of  which  it  moves  to  the  start  of  the  next 
raster  line,  and  so  on.  Once  it  reaches  the  bottom  of  the  screen,  the  electron  beam 
returns  to  the  upper  left  comer  of  the  screen  and  the  process  starts  over  again.  The 
illustration  below  shows  the  path  of  the  electron  beam. 

Remember  that  the  movement  of  the  electron  beam  is  controlled  by  the  video  card, 
not  by  the  monitor  itself. 


Electron  beam  scan  movement 
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The  resolution  of  the  monitor  naturally  controls  the  number  of  raster  lines  and 
columns  which  the  electron  beam  scans  when  creating  a  display.  Thus,  a  monitor 
which  has  only  200  raster  lines  of  640  raster  columns  each  clearly  cannot  handle 
the  high  resolutions  of  an  EGA  card  at  640x350  pixels.  The  four  monitor  types 
used  with  a  PC  generally  have  the  following  resolutions: 


iResolutions  of  different  monitors  1 

Monitor 

Vertical 

Horizontal 

Monochrome 

350 

720 

Color 

200 

640 

EGA 

350 

640 

Multisync 

varies^  up  to  600 

varies /  up  to  800 

The  CRT  controller 

The  CRT  Controller  or  CRTC  is  the  heart  of  a  video  card.  It  controls  the  operation 
of  the  video  card  and  generates  the  signals  the  monitor  needs  to  create  the  picture. 
Its  tasks  also  include  controlling  light  pens,  generating  the  cursor  and  controlling 
the  video  RAM. 

To  inform  the  monitor  of  the  next  raster  line,  the  CRTC  sends  a  display  enable 
signal  at  the  start  of  each  line,  which  activates  the  electron  beam.  While  the  beam 
moves  from  left  to  right  over  each  raster  column  of  the  line,  the  CRTC  controls 
the  individual  signals  for  the  electron  beam(s)  so  that  the  pixels  appear  on  the 
screen  as  desired.  At  the  end  of  the  line,  the  CRTC  disables  the  display  enable 
signal  so  that  the  electron  beam’s  return  to  the  next  raster  line  doesn’t  make  a 
visible  line  on  the  screen.  The  electron  beam  is  directed  to  the  left  edge  of  the 
following  raster  line  by  the  output  of  a  horizontal  synchronization  signal.  The 
display  enable  signal  is  again  enabled  at  the  start  of  the  next  raster  line,  and  the 
generation  of  the  next  line  begins. 

Overscan 

Since  the  time  that  the  electron  beam  needs  to  return  to  the  start  of  the  next  line  is 
less  than  the  time  the  CRTC  needs  to  get  and  prepare  new  information  from  the 
video  RAM,  there  is  a  short  pause.  But  the  electron  beam  cannot  be  stopped,  so 
we  get  something  called  overscan^  which  is  visible  as  the  left  and  right  borda*s  of 
the  actual  screen  contents.  Although  this  is  an  undesirable  side  effect  in  one  sense, 
it  is  useful  because  it  prevents  the  edges  of  the  screen  contents  from  being  hidden 
by  the  edge  of  the  monitor.  If  the  electron  beam  is  enabled  while  it  is  traveling 
over  this  border,  a  color  screen  border  can  be  created. 
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Once  the  electron  beam  reaches  the  end  of  the  last  raster  line,  the  display  enable 
signal  is  disabled,  and  a  vertical  synchronization  signal  is  sent.  The  electron  beam 
returns  to  the  upper  left  comer  of  the  screen.  Again  the  display  enable  signal  is  re¬ 
enabled  and  scanning  again  begins. 

Pause  and  overscan 

As  with  the  horizontal  electron  beam  return,  a  pause  results  which  is  displayed  in 
the  form  of  overscan,  creating  a  vertical  screen  border. 

Signal  timing 

The  timing  of  individual  signals  varies  from  video  mode  to  video  mode.  For  this 
reason,  the  CRTC  has  a  number  of  registers  which  describe  the  signal  outputs  and 
their  timing.  The  structure  of  these  registers  and  how  they  are  programmed  will  be 
discussed  in  the  remainder  of  this  section.  Many  of  these  registers  come  from  the 
registers  of  the  6845  video  controller  from  Motorola.  This  controller  is  used  in  the 
MDA,  CGA,  and  Hercules  graphics  cards.  The  EGA  and  VGA  cards  use  a  special 
VLSI  (very  large  scale  integration)  chip  as  a  CRTC,  and  its  registers  are  somewhat 
more  complicated.  The  techniques  described  here  are  intended  as  general 
descriptions  for  all  video  cards. 
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1  Registers  of  the  6845  video  controller  from  Motorola  I 

Reg. 

Meaning 

Access 

OOH 

Total  horizontal  character 

Write 

OlH 

Display  horizontal  character 

Write 

02H 

Horizontal  synchronization  signal  after  _ char 

Write 

03H 

Duration  of  horizontal  synchronization  signal  in  char. 

Write 

04H 

Total  vertical  character 

Write 

OSH 

Adjust  vertical  character 

Write 

06H 

Display  vertical  character 

Write 

07H 

Vertical  synchronization  signal  after _ char 

Write 

OSH 

Interlace  mode 

Write 

09H 

Number  of  scan  lines  per  screen  line 

Write 

OAH 

Starting  line  of  screen  cursor 

Write 

OBH 

Ending  line  of  screen  cursor 

Write 

These  registers,  like  all  of  the  other  regist^s  on  the  video  card,  are  accessed  via  I/O 
ports  with  the  assembly  language  instructions  IN  and  OUT.  The  registers  of  the 
CRTC  are  accessed  through  a  special  address  register,  rather  than  directly  from  the 
address  space  of  the  processor.  The  number  of  the  desired  CRTC  register  is  written 
to  the  port  corresponding  to  this  address  register.  Then  the  contents  of  this  register 
can  be  read  into  a  special  data  register  with  the  IN  assembly  language  instruction. 
If  a  value  is  to  be  written  to  the  addressed  register,  it  must  be  transferred  to  the  data 
register  with  the  OUT  instruction.  Then  the  CRTC  automatically  places  it  in  the 
desired  register.  These  two  registers  are  actually  found  at  successive  port  addresses, 
but  these  addresses  vary  from  video  card  to  video  card. 

We  will  include  tables  throughout  the  chapter  to  describe  the  contents  of  individual 
CRTC  registers  under  the  various  video  modes.  Hwe’s  an  example  which  shows 
how  the  contents  of  these  registers  are  calculated  and  how  the  in^vidual  registers 
are  related  to  each  other.  If  you  try  some  of  these  calculations  with  your  calculator 
or  PC,  you  will  notice  that  some  of  them  do  not  work  out  evenly.  But  since  the 
registers  of  the  CRTC  hold  only  integer  values,  they  will  be  rounded  up  or  down. 

The  basis  for  the  various  calculations  are  the  bandwidth  and  the  horizontal  and 
vertical  scan  rates  of  a  monitor. 


1  Bandwidth  and  scan  rates  of 

different  video  cards 

Video  syst^ 
rate 

Resolution 

Bandwidth 

Vert,  scan  rate 

Horiz.  scan 

CGA 

640  X  200 

■min 

15.75  KHz  1 

HGC 

640  X  200 

BEKElSHHi 

EGA 

640  X  350 

640  X  200 

720  X  350 

16.257  MHz  60  Hz 
14.318  MHz  60  Hz 
16.257  MHz  50  Hz 

21.85  KHz 

15.75  KHz 

18.43  KHz 

1  (*MHz -Megahertz,  KHz=Kilohertz,  Hz»Hertz 

The  bandwidths  in  the  figure  above  specify  the  number  of  points  which  the 
electron  beam  scans  per  second,  and  is  therefore  also  called  the  point  or  dot  rate. 
The  vertical  scan  rate  specifies  the  number  of  screen  refreshes  per  second,  while  the 
horizontal  scan  rate  refers  to  the  number  of  raster  lines  which  the  electron  beam 
scans  p^  second. 
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Starting  with  these  values,  let's  practice  calculating  the  individual  CRTC  register 
values  for  the  80x25  character  text  mode  on  a  CGA  card. 

Dividing  the  bandwidth  by  the  horizontal  scan  rate  we  get  the  number  of  pixels 
(screen  dots)  per  raster  line. 

Bandwidth  14.318  MHz 

+  Horizontal  scan  rate  15.570  KHz 


Pixels  per  line  919 

Since  the  CRTC  registers  generally  refer  to  the  number  of  characters  rather  than 
pixels,  this  value  must  be  convmed  to  the  number  of  characters  per  line.  This  is 
done  by  dividing  the  number  of  pixels  per  line  by  the  width  of  the  character 
matrix.  On  the  CGA  card  this  is  eight  pixels. 

Pixels  per  line  919 

+  Pixels  per  character  8 


Characters  per  line  114 

This  value,  decremented  by  one,  is  placed  in  the  first  register  of  the  CRTC  and 
specifies  the  total  number  of  characters  per  line.  In  the  second  register  we  load  the 
number  of  characters  that  will  actually  be  displayed  per  line.  The  80x25  character 
text  mode  usually  offers  80  characters. 

The  difference  between  the  total  and  the  number  of  characters  actually  displayed  per 
line  is  the  number  of  characters  which  can  be  displayed  between  the  horizontal 
return  and  the  overscan.  The  difference  in  this  case  is  34  characters. 

The  duration  of  the  horizontal  beam  return  must  be  entered  in  the  fourth  register  of 
the  CRTC.  This  register  stores  the  number  of  characters  which  could  be  displayed 
during  this  time,  rather  than  the  actual  time  duration.  The  monitor  specifications 
define  this  instead  of  the  video  card  itself.  As  a  rule  this  number  is  between  5%  and 
15%  of  the  total  number  of  characters  per  line.  A  color  monitor  uses  exactly  ten 
charactCTs. 

This  leaves  24  characters  for  the  overscan  (the  horizontal  screen  border).  The  third 
CRTC  register  specifies  how  these  characters  are  divided  between  the  left  and  right 
screen  borders.  This  register  specifies  the  number  of  character  positions  which  will 
be  scanned  before  the  horizontal  beam  return  occurs.  The  BIOS  specifies  the  value 
90  here,  or  after  ten  characters  have  been  displayed  for  the  screen  borders.  The 
remaining  14  characters  are  placed  at  the  start  of  the  next  line  and  form  the  left 
screen  border. 

The  calculations  for  the  vertical  data,  the  number  of  vertical  lines,  the  position  of 
the  vertical  synchronization  signal,  etc.,  follow  a  similar  scheme.  The  first 
calculation  is  the  number  of  raster  lines  per  screen.  This  results  from  the  division 


465 


10.  Accessing  and  Programming  the  Video  Cards 


PC  System  Programming 


of  the  number  of  lines  displayed  per  second  by  the  number  of  screen  refreshes  per 
second: 


Pixels  per  line  919 

Pixels  per  character  8 


Characters  per  line  114 

Horizontal  scan  rate  15.750  KHz 

Screen  refreshes  60  Hz 


Raster  lines  262 

Since  the  characters  in  CGA  text  mode  are  eight  pixels  high  by  eight  pixels  wide, 
we  again  divide  by  eight  to  get  the  number  of  text  lines  per  screen: 

Raster  lines  262 

+  Pixels  per  character  8 


Lines  per  screen  32 

This  result  must  be  decremented  by  one  and  then  loaded  into  the  fifth  register  of 
the  CRTC.  The  number  of  displayed  lines  is  loaded  into  the  seventh  register.  Since 
seven  fewer  lines  are  displayed  than  are  actually  available,  these  extra  lines  are  used 
for  the  vertical  beam  return  and  overscan,  whereby  the  vertical  beam  return  begins 
after  the  28th  line. 

The  character  height  must  be  decremented  by  one  and  loaded  into  CRTC  register 
nine.  The  decrement  results  is  7  in  this  example.  This  value  also  determines  the 
range  for  the  values  loaded  into  register  ten  and  eleven.  They  specify  the  first  and 
last  raster  lines  of  the  screen  cursor.  The  cursor  position  is  determined  by  the 
contents  of  registers  14  and  15.  They  refer  to  the  distance  of  the  character  from  the 
upper  left  comer  of  the  screen,  instead  of  line  and  column.  This  value  is  calculated 
by  multiplying  the  cursor  line  by  the  number  of  columns  per  line  and  then  adding 
the  cursor  column.  The  high  byte  of  the  result  must  be  loaded  into  register  14  and 
the  low  byte  in  register  15. 

The  video  RAM  area 

The  contents  of  registers  12  and  13  determine  the  area  of  video  RAM  displayed  on 
the  screen.  To  understand  these  registers,  we  first  need  to  know  something  about 
the  way  video  RAM  is  organized. 

The  third  component  of  the  video  system  determines  what  will  eventually  be 
displayed  on  the  screen.  In  text  mode,  the  video  RAM  contains  the  ASCII  codes  of 
the  characters  to  be  displayed  and  their  attributes.  While  the  organization  of  video 
RAM  in  this  mode  is  identical  for  all  of  the  video  cards  discussed  here,  the 
organization  for  graphic  mode  varies  from  card  to  card.  The  description  of  each  card 
discusses  the  way  video  RAM  organizes  graphic  modes  (more  on  this  later). 
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As  the  illustration  below  shows,  each  screen  position  occupies  two  bytes  in  video 
RAM.  The  ASCII  code  of  the  character  to  be  displayed  is  placed  in  the  first  of 
these  two  bytes,  the  one  with  the  even  address.  By  using  eight  bits  per  character 
code,  a  maximum  of  256  different  charact^  can  be  displayed. 


RAM 


25  Characters 


15  13  11  9876543210 


Attribute  ASCI I - 
Code 


Normal  text  mode  structure  in  video  RAM 

After  the  ASCII  code,  and  always  at  an  odd  offset  address,  follows  the  attribute 
byte,  which  deflnes  the  appearance  of  the  character  on  the  screen.  The  attribute 
controller  divides  it  into  two  nibbles,  whereby  the  iq>per  nibble  (bits  four  to  seven) 
describes  the  character  background,  and  the  lower  nibble  (bits  zero  to  three) 
describes  the  character  foreground.  This  results  in  two  values  between  zero  and 
fifteen  which  are  interpreted  dqtending  on  the  type  of  monitor  attached.  With  a 
color  monitor  (and  a  CGA  or  EGA  card)  both  v^ues  select  one  of  16  possible 
colors.  Each  character  on  the  screen  can  thus  have  its  own  foreground  and 
background  colors. 

A  monochrome  monitor  caimot  display  colors,  regardless  of  the  adapter.  Here  the 
attribute  controls  whether  the  character  is  displayed  at  high  or  low  intensity, 
inverse,  or  underlined. 
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Character  organization  in  video  RAM 

To  access  video  RAM,  you  must  know  how  the  individual  characters  are  organized 
within  this  memory.  This  organization  is  similar  to  character  display  on  the 
screen. 

The  first  character  on  the  screen  (the  character  in  the  upper  left  comer)  is  also  the 
first  character  in  video  RAM,  located  at  offset  position  OOOOH.  The  next  character 
to  the  right  is  located  at  offset  position  0002H.  All  80  characters  of  the  first  screen 
line  follow  in  this  manner.  Since  each  screen  character  takes  two  bytes  of  memory, 
each  line  occupies  160  bytes  of  RAM.  The  first  character  of  the  second  screen  line 
follows  the  last  character  of  the  first  line,  and  so  on. 

Finding  character  locations  in  video  RAM 

You  can  easily  find  the  starting  address  of  a  line  within  video  RAM  by 
multiplying  the  line  number  (starting  with  zero)  by  160.  To  get  from  the 
beginning  of  the  line  to  a  character  within  the  line,  the  distance  of  the  character 
from  the  start  of  the  line  must  be  added  to  this  value.  Since  each  character  takes 
two  bytes,  this  is  done  simply  by  multiplying  the  column  number  (also  starting  at 
zero)  by  two.  Adding  both  products  together  yields  the  offset  position  of  the 
character  in  the  video  RAM.  These  calculations  can  be  combined  into  a  single 
formula: 


Of f set_position (row,  column)  =  row  *  160  +  column  *  2 

Note:  Since  only  40  characters  per  line  are  displayed  in  40-column  video 

modes,  the  factor  80  must  replace  the  origin^  160. 

The  RAM  memory  of  the  video  card  is  integrated  into  the  normal  RAM  of  the  PC 
system,  so  you  can  use  normal  memory  access  commands  to  access  video  RAM. 
You  must  know  the  segment  address  of  video  RAM,  which  is  used  together  with 
the  formula  above  to  find  the  offset  position.  Section  10.7  shows  how  this  can  be 
done  easily  in  assembly  language,  BASIC,  Pascal,  and  C. 

Now  that  we  have  discussed  the  most  important  similarities  between  the  four  video 
cards,  the  following  four  sections  describe  the  capabilities  of  these  cards.  In 
addition,  these  sections  explain  how  these  capabilities  can  be  used  for  optimal 
screen  output 
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1 0.2  The  IBM  Monochrome  Card 


The  IBM  Monochrome  Display  Ad^ter,  or  MDA,  is  probably  the  oldest  of  the 
video  cards.  This  card  is  bas^  on  the  Motorola  6845  video  controller,  which  is  an 
intelligent  peripheral  chip.  The  6845  controller  constructs  a  display  by  generating 
the  proper  signals  for  the  monitor  from  video  RAM. 

This  card  is  excellent  for  text  display.  This  is  achieved  with  a  9x14  character 
matrix,  which  permits  high-resolution  character  display.  The  format  of  this  matrix 
is  unusual  since  a  character  genontor  containing  the  bit  pattern  of  each  character 
can  only  produce  characters  8  pixels  wide.  Characters  from  the  IBM  character  set 
may  not  connect  with  each  other  (e.g.,  using  box  characters  to  draw  a  box).  A 
circuit  on  the  graphics  card  sidesteps  this  disadvantage  by  copying  the  eighth  pixel 
of  the  line  into  the  ninth  pixel  for  any  characters  whose  ASCII  codes  are  between 
BOH  and  DFH.  This  allows  the  horizontal  box  drawing  characters  to  connect 


Column 

Row 


0 


2  3 


5  6 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 
13 


V 


Coding  stored  In  ROM  character  set 


Monochrome  display  adapter— 9x14  character  matrix 

The  character  generator  requires  one  byte  for  each  screen  line:  one  bit  per  pixel, 
eight  bits  per  line.  Each  chai^ter  requires  14  bytes.  The  complete  character  set  has 
a  memory  requirement  of  almost  4K,  stcM^  in  a  ROM  chip  on  the  card.  For  some 
reason  the  card  has  an  8K  ROM,  leaving  the  second  bank  of  4K  unused. 

Video  RAM  on  the  MDA 

The  video  RAM  of  the  card  starts  at  address  B000:00(X)  and  extends  over  4K  (4,096 
bytes).  Since  the  screen  display  only  has  space  for  2,000  charact^  and  requires 
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only  4,000  bytes  of  memory  for  those  characters,  the  unused  96  bytes  at  the  end  of 
video  RAM  are  available  for  other  applications. 

The  following  figure  shows  the  meanings  of  the  different  values  representing  the 
attribute  byte: 


7  654  321  Obit 


Attribute  byte  values— IBM  monochrome  display  adapter 

Any  combination  of  bits  can  be  loaded  into  this  byte.  However,  the  MDA  only 
accepts  the  following  combinations: 


Byte  combinations-^BM  monochrome  display  adapter 


Besides  these  bit  combinations,  bits  3  and  7  of  the  attribute  byte  can  be  set  or 
unset.  Bit  3  defines  the  intensity  of  the  foreground  display.  When  this  bit  is  set, 
the  characters  appear  in  higher  intensity.  Bit  Ts  purpose  varies  with  the  contents 
of  the  control  registers  (more  on  this  later).  For  now,  all  you  need  to  know  is  that 
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bit  7  can  either  enable  blinking  characters,  or  enable  an  intensity  matching  the 
background  color. 

Monochrome  cards  have  two  more  registers  available:  the  control  register  and  the 
status  register. 

7  6  5  4  3  2  1  0  bit 


L_ 

Always  1 

OsScreen  off 
fsScreen  on 

Bit  7  of  the  attribute 
byte: 

0=brlght  background 
IsbIInking 

Control  register 


MDA  control  register 

The  control  register  located  at  port  3B8H  controls  the  monochrome  display 
adapter's  different  functions.  As  the  figure  below  shows,  only  bits  0, 3  and  5  are  of 
importance.  Bit  0  controls  the  resolution  on  the  card.  Although  the  card  only 
supports  one  resolution  (80x25  characters),  this  bit  must  be  set  to  1  during  system 
initialization.  Otherwise  the  computer  goes  into  an  infinite  wait  loop.  Bit  3 
controls  the  creation  of  a  visible  display  on  the  monitor.  If  bit  3  is  set  to  0,  the 
screen  is  black  and  the  blinking  cursor  disappears.  If  bit  3  is  set  to  1,  the  display 
returns  to  the  screen.  Bit  5  has  a  similar  function:  If  bit  7  in  the  attribute  byte  of 
the  character  is  set  to  I,  it  enables  blinking  characters.  If  bit  7  contains  the  value 
0,  the  character  appears,  unblinking,  in  front  of  a  light  background  color.  This 
means  that  bit  7  of  the  attribute  byte  acts  as  an  intensity  bit  for  the  background. 
This  register  can  only  be  written.  This  makes  it  impossible  for  a  program  to 
determine  whether  the  display  is  turned  on  or  off.  The  normal  value  for  this 
register  is  29H,  meaning  that  all  three  relevant  bits  default  to  1. 
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l_ 

Horizontal 
synchronization 
signal:  0=off,  1=on 

OsCurrent  pixel  off 
IsCurrent  pixel  on 

Status  registers  (3BAH) 


MDA  status  register 

Only  bits  0  and  3  are  used  in  the  status  register;  all  the  other  bits  must  contain  the 
value  1.  Unlike  the  control  register,  programs  can  read  this  register,  but  register 
contents  cannot  be  changed  by  program  code. 

Horizontal  synchronization 

Bit  0  indicates  if  a  horizontal  synchronization  signal  is  being  sent  to  the  display 
screen.  The  video  card  sends  this  signal  after  creating  a  screen  line  (not  to  be 
confused  with  a  text  line,  which  consists  of  14  screen  lines)  on  the  screen.  This 
signal  informs  the  electron  gun,  which  "draws"  the  picture  on  the  screen,  that  it 
should  return  to  the  left  border  of  the  current  screen  line.  In  this  case  the  bit  has 
the  value  1.  Bit  3  contains  the  value  of  the  pixel  where  the  electron  beam  is 
currently  located.  A  1  signals  that  the  pixel  is  visible  on  the  screen  and  0  means 
that  the  screen  remains  black  at  this  location. 

MDA  internal  registers 

Besides  the  two  registers  directly  connected  to  the  hardware  of  the  monochrome 
display  adapter,  the  6845  video  processor  contains  a  series  of  internal  registers. 
These  18  registers  are  open  to  user  access  through  the  6845  index  register  and  data 
register.  The  index  register  is  connected  to  port  address  3B4H,  the  data  register  at 
port  address  3B5H.  You  can  only  write  to  the  6845  registers — you  cannot  read  data 
from  them. 

When  you  enter  a  value  into  one  of  the  18  registers,  the  number  of  the  register  (0- 
17)  passes  first  into  the  index  register.  Then  the  value  which  is  transmitted  to  the 
register  passes  into  the  data  register.  The  6845  then  transmits  the  indicated  value  to 
the  proper  register.  Most  of  these  18  registers  should  not  be  modified,  since  they 
contain  impoftant  data  about  the  screen  structure  (e.g.,  synchronization  signals) 
and  incorrect  values  in  these  registers  can  damage  the  monitor.  The  following  table 
shows  the  meanings  of  the  individual  registers  and  the  values  which  ensure  a 
correct  display. 
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Registers  of  the  CRTC  register  in  80x25  text  mode 
on  the  Monochrome  Display  Adapter  (MDA) 

1^2: _ 

Meaning 

Content 

EEIzH 

Total  horizontal  character 

g? 

EEH 

80 

EEIIH 

82 

ESiHi 

Duration  of  horizontal  synchronization  signal  in  char. 

15 

EQxH 

Total  vertical  character 

25 

Esm 

Adjust  vertical  character 

6 

EI3i 

Display  vertical  character 

25 

EESi 

25 

EEIOH 

Interlace  mode 

2 

EEm 

Number  of  scan  lines  per  screen  line 

13 

ESIHi 

Starting  line  of  blinking  screen  cursor 

11 

Ending  line  of  blinking  screen  cursor 

12 

Esm 

Starting  address  of  displayed  screen  page  (low  byte) 

0 

esioh 

Starting  address  of  displayed  screen  page  (high  byte) 

0 

E!^91 

Character  address  of  blinking  screen  cursor  (high  byte) 

0 

ESi^l 

Character  address  of  blinking  screen  cursor  (low  byte) 

0 

[Em 

* 

beh 

★ 

*not  available  on  MDA  I 

The  following  program  makes  full  use  of  the  monochrome  display  adapter's 
capabilities.  It  was  written  in  assembly  language.  The  individual  routines  are  fully 
documented  and  require  no  additional  explanation.  The  demonstration  program  built 
into  the  listing  shows  practical  application  of  the  individual  routines. 

Assembler  listing:  VMONO.ASM 


.*********************************************************************. 
;*  V  M  0  N  0  *; 


•  — 

;* 

.  * 
t 

Task 

:  makes  some  elementary  functions  available  for  *; 
access  to  the  monochrome  display  screen  *; 

$ 

•  ★ 

$ 

Info 

:  all  functions  subdivide  the  screen 

*; 

.  * 

Into  columns  0  to  79  and  lines  0  to  24 

t 

.  * 

Author 

:  MICHAEL  TISCHER 

*; 

.  ★ 
t 

Developed  on 

:  8/11/87 

★  • 
f 

.  * 
t 

•  * 

Last  Update 

:  6/14/89 

★  . 
t 

_ * . 

.  * 
t 

assembly 

:  MASM  VMONO; 

*. 

t 

;* 

• 

_ 

LINK  VMONO; 

*; 

— *. 

.★★*******************************************************************. 


CONTROL  REG 

s 

03B8h 

; Control  register  port  address 

ADDRESS_6845 

- 

04B4h 

;6845  address  register 

DATA  6845 

- 

03B5h 

;6845  data  register 

VIO  SEG 

- 

OBOOOh 

; Segment  address  of  video  RAM 

CUR_START 

= 

10 

/Register  #  CRTC:  Starting  cursor  line 

CUR  END 

11 

/Register  #  CRTC:  Ending  cursor  line 

CURPOS  HI 

14 

/Register  #  CRTC:  Cursor  pos.  hi  byte 

CURPOS_LO 

* 

15 

/Register  #  CRTC:  Cursor  pos.  lo  byte 

DELAY 

- 

20000 

/Counter  for  delay  loop 
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stack  segment  para  stack  ; Definition  of  stack  segment 

dw  256  dup  (?)  ; 256-word  stack 

stack  ends  ;End  of  stack  segment 

data  segment  para  'DATA*  /Define  data  segment 

/“  the  Data  for  the  Demo-Program 
strl  db  "a"  ,0 

str2  db  "  >PC  SYSTEM  PROGRAM4ING<  ",0 

str3  db  ••  window  1  •',0 

str4  db  "  window  2  **,0 

str5  db  "  the  program  is  stopped  by  •* 

db  "  pressing  a  Key....  ",0 

initm  db  13,10, "VMONO  (c)  1987  by  Michael  Tischer", 13, 10, 13, 10 
db  "This  demonstration  program  only  runs  with  " 
db  ••  a  monochrome**,  13, 10,  "display  card.  If  your  PC  " 
db  "has  another  type  of  display  card, ",13,10 
db  "please  enter  <s>  to  stop  the  " 
db  "  program. ",13,10, "Otherwise  press  any  " 
db  "key  to  start  ",13,10 
db  "the  program  ...",13,10,"$" 

linen  dw  0*160,1*160,2*160  /Start  addresses  of  the  lines  as 

dw  3*160,4*160,5*160  /offset  addresses  in  the  video  RAM 
dw  6*160,7*160,8*160 

dw  9*160,10*160,11*160,12*160,13*160,14*160,15*160,16*160 
dw  17*160,18*160,19*160,20*160,21*160,22*160,23*160,24*160 

data  ends  /End  of  data  segment 

/  =*  Code 
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startdemo 


demol: 


demo2: 


arrow; 
arrowO : 


arrowl : 


label  near 


mov 

cx, OdOOh 

/Enable  full  cursor 

call 

cdef 

call 

els 

/Clear  screen 

Fill  screen  with 

ASCII  characters  - 

xor 

di,di 

/Start  in  u^Jer  left  comer 

mov 

si,  offset 

strl 

/Offset  address  of  stringl 

mov 

cx, 2000 

/2,000  characters  fit  on  the  screen 

mov 

al,07h 

/white  letters  on  black  background 

call 

print 

/Display  string 

Inc 

strl 

/Increment  character  in  test  string 

jne 

d^o2 

/NUL  code  suppressed 

inc 

strl 

loop  demol 

/Repeat  output 

1 

Create  window  1  and  window  2  - 

mov 

bx,0508h 

/Upper  left  comer  of  window  1 

mov 

dx,1316h 

/Lower  right  corner  of  window  1 

mov 

ah, 07h 

/White  letters,  black  background 

call 

clear 

/Clear  window  1 

mov 

bx, 3C02h 

/Upper  left  comer  of  window  2 

mov 

dx, 4A10h 

/Lower  right  corner  window  2 

call 

clear 

/Clear  window  2 

mov 

bx, 0508h 

/Upper  left  comer  of  window  1 

call 

calo 

/Convert  to  offset  address 

mov 

si,  offset 

str3 

/Offset  address  string  3 

mov 

ah,70h 

/Black  characters,  white  background 

call 

print 

/Display  string  3 

mov 

bx, 3C02h 

/Upper  left  corner  of  window  2 

call 

calo 

/Convert  to  offset  address 

mov 

si, offset 

str4 

/Offset  address  string  4 

call 

print 

/Display  string  4 

xor 

di,di 

/UK>er  left  display  corner 

mov 

si,  offset 

str5 

/Offset  address  string  5 

call 

print 

/Display  string  5 

; —  1 

. 

. 

ogo 

mov 

bx, lEOCh 

/Column  30,  line  12 

call 

calo 

/Convert  offset  address 

mov 

si,  offset 

str2 

/Offset  address  string  2 

mov 

ah, OFOh 

/Inverse  blinking 

call  print 

/Display  string  2 

; —  Fill  window  with 

arrows  - 

xor 

ch,  ch 

/Hi-byte  of  the  counter  to  0 

mov 

bl,l 

/Asterisk 

push  bx 

/Push  BX  on  the  stack 

mov 

di,  offset 

str3 

/Draw  arrow  line  in  string  3 

mov 

cl,  15 

/Total  of  15  characters  in  a  line 

sub 

cl,bl 

/Calculate  number  of  spaces 

shr 

cl,l 

/Divide  by  2  (for  left  half) 

or 

cl,  cl 

/No  blanks  ? 

je 

arrowl 

/YES  — >  ARROWl 

mov 

al,-  •* 

rep 

stosb 

/Draw  blanks  in  string  3 

mov 

cl,bl 

/Number  of  asterisks  in  counter 

mov 

al,-*« 

rep 

stosb 

/Draw  stars  in  string  3 

mov 

cl,  15 

/Total  of  15  characters  in  a  line 

sub 

cl,bl 

/Calculate  number  of  blanks 

shr 

cl,l 

/Divide  by  2  (for  right  half) 

or 

cl,  cl 

/No  blanks? 

je 

arrow2 

/YES  -->  ARROW2 

mov 

al,"  •* 
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arrow2 : 


waitlp; 


end  it; 


rep 

stosb 

/Draw  blanks  in  string  3 

mov 

bx,0509h 

/below  the  first  line  of  window  1 

call 

calo 

/Convert  to  offset  address 

mov 

si, offset  str3 

/Offset  address  string  3 

mov 

ah,07h 

/White  characters,  black  background 

call  print 

/Display  string  3 

mov 

bx,3C10h 

/into  the  lowest  line  of  window  2 

call 

calo 

/Convert  offset  address 

call  print 

/Display  string  3 

mov 

cx, DELAY 

/Loop  counter 

loop  waitlp 

/Count  loop  to  0 

Scroll  window  1 

line  down  - 

mov 

bx,0509h 

/Uj^r  left  corner  of  window  1 

mov 

dx,1316h 

/Lower  right  comer  window  1 

mov 

cl,l 

/Scroll  down 

call 

scrolldn 

/one  line 

Scroll  window  2 

one  line  up  - 

mov 

bx,3C03h 

/UK>er  left  corner  window  2 

mov 

dx, 4A10h 

/Lower  right  corner  window  2 

call 

scrollup 

/Scroll  up 

7 

Was  a  key  pressed?  (end  program)  - 

mov 

ah,l 

/Function  number  for  testing  key 

int 

16h 

/Call  BIOS  keyboard  interrupt 

jne 

end_it 

/Keypress  ->  goto  end  of  program 

NO,  display  next 

arrow  - 

pop 

bx 

/Pop  BX  from  stack  again 

add 

bl,2 

/2  more  stars  in  next  line 

cmp 

bl,17 

/Reached  17  ? 

jne 

arrowO 

/NO  — >  next  arrow 

jmp 

arrow 

/No  key  — >  next  arrow 

Get  ready  to  end  program 

xor 

ah,  ah 

/Get  function  number  for  key 

int 

16h 

/Call  BlOS-keyboard-interrupt 

mov 

cx, ODOCh 

/Restore  normal  cursor 

call 

cdef 

call 

els 

/Clear  screen 

jmp 

ende 

/Go  to  end  of  program 

demo 


endp 


Functions 


; —  SOFF:  switches  the  display  off  - 
; —  Input  ;  none 

; —  Output  :  none 

; —  register  :  AX  and  DX  are  changed 


SOFF 


proc  near 


mov  dx, CONTROL_REG 
in  al,dx 
and  al, 11110111b 
out  dx,  al 


/Address  of  display  control  register 

/read  its  content 

/bit  3=0;  display  off 

/set  new  value  (display  off) 


SOFF 


ret 

endp 


/back  to  caller 
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; —  SC»I:  switches  the  display  on  — 

; —  Input  :  none 
; —  Output  ;  none 
; —  register  :  TOC  and  DX  are  changed 

SON  proc  near 

mov  dx,  CC»rrROL_REG 
in  al,dx 
or  al,8 
out  dx,  al 
ret 

SON  endp 

; —  CDEF:  sets  the  start  and  end  line  of  the  cursor 
; —  Input  ;  CL  *  Start  line 
; —  CH  *  End  line 

; —  Output  :  none 

; —  register  :  AX  and  DX  are  changed 
cdef  proc  near 

mov  al , CUR_START 
mov  ah,  cl 
call  setvk 
mov  al,CUR_END 
mov  ah, ch 
jmp  short  setvk 

cdef  endp 

; —  SETBLINK:  sets  the  blinking  display  cursor  - 

; —  Input  :  DI  =  offset  address  of  the  cursor 
; —  Output  :  none 

; —  register  :  BX,  AX  and  DX  are  changed 
setblink  proc  near 

/Transmit  offset  to  BX 
/Register  15:Hl-byte  of  cursor  offset 
/Hl-byte  of  the  offset 
/Transmit  to  video  controller 
/Register  ISiLo-byte  of  cursor  offset 
/Lo-byte  of  the  offset 

/ —  SETVK  is  called  automatically  - 

setblink  endp 

/-SETVK:  sets  a  byte  in  one  of  the  registers  of  the  video  controller  — 
/ —  Input  :  AL  *  number  of  the  register 
/ —  AH  »  new  content  of  the  register 

/ —  Output  :  none 
/ —  register  :  DX  and  AL  are  changed 

setvk  proc  near 

mov  dx,ADDRESS_6845 
out  dx, al 
jmp  short  $+2 
inc  dx 
mov  al,ah 
out  dx, al 
ret 

setvk  endp 

/ —  GETVK:  reads  a  byte  from  one  register  of  the  video  controllers  - 
/ —  Input  :  AL  =  number  of  the  register 


/Address  of  the  index  register 

/Send  number  of  the  register 

/anall  I/O  pause 

/Address  of  the  index  register 

/Content  to  AL 

/Set  new  content 

/Back  to  caller 


mov  bx, dl 

mov  al,CURPOS_HI 

mov  ah,bh 

call  setvk 

mov  al,CURPOS_LO 

mov  ah, bl 


/Register  10:  start  line 

/Start  line  to  AH 

/Transmit  to  video  controller 

/Register  11:  end  line 

/End  line  to  AH 

/Transmit  to  video  controller 


/Address  of  display  control  register 
/Read  its  content 
/Bit  3-1:  display  on 
/Set  new  value  (display  on) 

/Back  to  caller 
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; —  Output  :  AL  “  content  of  the  register 
; —  register  :  DX  and  AL  are  changed 

getvJc  proc  near 

mov  dx,ADDRESS_6845 
out  dx,  al 
jirp  short  $+2 
inc  dx 
in  al,dx 
ret 

getvk  endp 

; —  SCROLLUP:  scrolls  a  window  up  by  N  lines  - 

; —  Input  :  BL  *  line  upper  left 

; —  BH  *  column  upper  left 

; —  DL  =  line  lower  right 

; —  DH  *  column  lower  right 

; —  CL  “  number  of  lines  to  scroll 

; —  Output  ;  none 

; —  register  :  only  FLAGS  are  changed 

; —  Info  :  the  display  lines  released  are  erased 

scrollup  proc  near 


/Address  of  the  index  register 
/Send  number  of  the  register 

/Address  of  the  index  register 
/Read  content  to  AL 
/Back  to  caller 


cld 


/Increment  on  string  instructions 


push  ax 
push  bx 
push  di 
push  si 


/Push  all  changed  registers  on  the 
/stack 

/In  this  case  the  sequence 
/must  be  observed! 


push  bx 
push  cx 
push  dx 
sub  dl,bl 
inc  dl 
sub  dl,cl 
sub  dh,bh 
inc  dh 
call  calo 
mov  si,di 
add  bl,cl 
call  calo 
xchg  si,di 
push  ds 
push  es 

mov  ax,VIO_SEG 
mov  ds, ax 
mov  es,ax 
supl:  mov  ax,di 

mov  bx, si 
mov  cl,dh 
rep  movsw 
mov  di,ax 
mov  si,bx 
add  di,160 
add  si, 160 
dec  dl 
jne  supl 
pop  es 
pop  ds 
pop  dx 
pop  cx 
pop  bx 
mov  bl,dl 
sub  bl,cl 
inc  bl 
mov  ah, 07h 


/These  three  registers  are  restored 
/from  the  stack  before  ending 

/Calculate  the  number  of  lines 

/Deduct  number  of  lines  scrolled 
/Calculate  number  of  columns 

/Convert  upper  left  in  offset 
/Record  Address  in  SI 
/First  line  in  scrolled  window 
/Convert  first  line  to  offset 
/Exchange  SI  and  DI 
/Store  segment  register  on 
/the  stack 

/Segment  address  of  the  video  RAM 
/to  DS 
/and  ES 

/Record  DI  in  AX 

/Record  SI  in  BX 

/Number  of  column  in  counter 

/Move  a  line 

/Restore  DI  from  AX 

/Restore  SI  from  BX 

/Set  next  line 

/Processed  all  lines  ? 

/NO  — >  move  another  line 
/Get  segment  register  from 
/stack 

/Get  lower  right  corner 
/Read  number  of  lines 
/Get  upper  left  corner 
/Lower  line  to  BL 
/Deduct  number  of  lines 

/Color  :  black  on  white 


478 


Abacus 


10,2  The  IBM  Monochrome  Card 


call 

clear 

; Erase  lines  freed 

pop 

si 

;CX  and  DX  have  already 

pop 

di 

;been  read 

pop 

bx 

pop 

ax 

ret 

;Bac)c  to  caller 

scrollup 

endp 

SCROLLDN: 

scrolls  a  window  down  N  lines  - 

; —  Input 

: 

BL  “  line  upper  left 

; — 

BH  =  column 

upper  left 

; — 

DL  “  line  lower  right 

; — 

DH  «  column  lower  right 

; — 

CL  *  number 

of 

lines  to  scroll 

;  —  Output  : 

none 

; —  register  : 

only  FLAGS  are 

changed 

; —  Info 

: 

display  lines  released  are  erased 

scrolldn 

proc 

near 

cld 

; Increment  on  string  instructions 

push 

ax 

/Store  all  changed  registers  on  the 

push 

bx 

/stack 

push 

di 

/In  this  case  the  sequence 

push 

si 

/must  be  observed  ! 

push 

bx 

/These  three  registers  are  returned 

push 

cx 

/from  the  stack  before  the  end 

push 

dx 

/of  the  routine 

sub 

dh,bh 

/Calculate  the  number  of  the  column 

inc 

dh 

mov 

al,bl 

/Record  line  upper  left  in  AL 

mov 

bl,dl 

/Line  upper  right  to  line  ujper  left 

call 

calo 

/Convert  upper  left  into  offset 

mov 

si,dl 

/Record  address  in  SI 

sub 

bl,cl 

/Deduct  number  of  lines  to  scroll 

call 

calo 

/Convert  upper  left  in  offset 

xchg 

si,di 

/Exchange  SI  and  DI 

sub 

dl,al 

/Calculate  number  of  lines 

Inc 

dl 

/Deduct  number 

sub 

dl,cl 

/of  lines  to  be  scrolled 

push 

ds 

/Push  segment  register  onto  stack 

push 

es 

mov 

ax,VIO_SEG 

/Segment  address  of  video 

mov 

ds,ax 

/to  DS 

mov 

es,ax 

/and  ES 

sdnl: 

mov 

ax,di 

/Move  DI  to  AX 

mov 

bx,si 

/Move  SI  to  BX 

mov 

cl,dh 

/Number  column  in  counter 

rep  movsw 

/Scroll  one  line 

mov 

di,ax 

/Get  DI  from  AX 

mov 

si,bx 

/Restore  SI  from  BX 

sub 

di,160 

/Set  next  line 

sub 

si, 160 

dec 

dl 

/All  lines  processed  ? 

jne 

sdnl 

/NO  — >  scroll  another  line 

pop 

es 

/Get  segment  register  from 

pop 

ds 

/stack 

pop 

dx 

/Return  lower  right  comer 

pop 

cx 

/Return  number  of  lines 

pop 

bx 

/Return  upper  left  corner 

nK>v 

dl,bl 

/Ufper  line  to  DL 

add 

dl,cl 

/Add  number  of  lines 

dec 

dl 

nK>v 

ah, 07h 

/Color  :  black  on  white 
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call  clear 


; Erase  lines  which  were  released 


pop  si 
pop  dl 
pop  bx 
pop  ax 


;CX  and  DX  are 
;  already  returned 


;Baclc  to  caller 


scrolldn  endp 


—  CLS:  Clear  the  complete  screen  — 

—  Input  :  none 

—  Output  :  none 

—  register  :  only  FLAGS  are  changed 


mov  ah, 07h 
xor  bx,bx 
mov  dx, 4F18h 

; —  Execute  Clear 


; Color  is  white  on  black 
;Upper  left  is  (0/0) 

; Lower  right  is  (79/24) 


—  CLEAR:  fills  a  designated  display  with  space  characters  - 

—  Input  :  AH  “  Attribute/color 

BL  =  line  upper  left 
BH  *  column  upper  left 
DL  =  line  lower  right 

—  DH  =  column  lower  right 

—  Output  :  none 

—  register  :  only  FLAGS  are  changed 


cld 

push  cx 
push  dx 
push  si 
push  di 
push  es 
sub  dl,bl 
inc  dl 
sub  dh,  bh 
inc  dh 
call  calo 
mov  cx,VIO_SEG 
mov  es, cx 
xor  ch, ch 
mov  al , "  " 
mov  si,di 
mov  cl,dh 
rep  stosw 
mov  di,si 
add  di,160 
dec  dl 
jne  clearl 


; Increment  on  string  instructions 
; Store  all  registes  which 
;are  changed  on  the  stack 


; Calculate  number  of  lines 

; Calculate  number  of  columns 

; Offset  address  of  upper  left  corner 
; Segment  address  of  the  video  RAM 
;to  ES 

;Hi-bytes  of  the  counter  to  0 
; Space  character 
;Move  DI  to  SI 

; Number  of  column  in  counter 
; Store  space  character 
; Restore  DI  from  SI 
;Set  in  next  line 
;A11  lines  processed  ? 

;NO  — >  erase  another  line 


pop  es 
pop  di 
pop  si 
pop  dx 
pop  cx 
ret 


; Restore  registers  from 
;  stack 


;Back  to  caller 


clear  endp 


PRINT:  outputs  a  string  on  the  Display 
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—  Input 


—  Output 

—  register 

—  Info 


AH  “  Attribute/color 

DI  “  offset  address  of  the  first  character 
SI  »  offset  address  of  the  string  to  DS 
DI  points  behind  the  last  character  output 
AL,  DI  and  FLAGS  are  changed 

the  string  must  be  terminated  with  a  NUL-character . 
other  control  characters  are  not  recognized 


print 


proc  near 


cld 

push  si 
push  es 
push  dx 

mov  dx,VIO_SEG 
mov  es,dx 
jirp  print  1 


/Increment  on  string  instructions 
/Store  SI,  DX  and  ES  on  the  stack 


/Segment  address  of  the  video  RAM 
/First  to  DX  and  then  to  ES 
/YES  — >  Output  finished 


printO: 

printl: 


stosw 

lodsb 


/Store  attribute  and  color  in  V-RAM 
/Get  next  character  frcan  the  string 


or 

al,al 

/Is  it  NUL 

jne 

print 0 

/NO  — >  output 

printer 

pop 

dx 

/Get  SI,  DX  and  ES  back  from 

pop 

es 

pop 

si 

ret 

/Back  to  caller 

print 

endp 

/-  CALO: 

converts  line  and  column  into  offset  address  - 

/ —  Input 

: 

BL  =  line 

; — 

BH  “  column 

/ —  Output  : 

DI  =  the  offset 

address 

/ —  Registers: 

DI  and  FLAGS  are  changed 

calo 

proc 

near 

push 

ax 

/Store  AX  on  the  stack 

push 

bx 

/Store  BX  on  the  stack 

shl 

bx,  1 

/Column  and  line  times  2 

mov 

al,bh 

/Column  to  AL 

xor 

bh,bh 

/Get  Hi-byte 

mov 

di, [linen+bx] 

/Offset  address  of  the  line 

xor 

ah,  ah 

/Hl-byte  for  column  offset 

add 

dl,ax 

/Add  line-  and  column  offset 

pop 

bx 

/Get  BX  from  stack  again 

pop 

ax 

/Get  AX  from  stack  again 

ret 

/Back  to  caller 

calo 

endp 

End 


code  ends 

end  demo 


/End  of  the  CCX)E  segment 
/Start  program  execution  w/  demo 
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10.3  The  Hercules  Graphic  Card 

The  Hercules  display  adapts  displays  text  in  both  text  mode  and  graphics  mode, 
with  a  graphic  resolution  of  720x348  pixels.  This  card  contains  enough  RAM  for 
two  display  pages.  Each  display  page  is  32K,  so  video  RAM  can  acc^t  a  4K  text 
page  and  a  gn^hic  page.  The  Erst  display  page  extends  from  address  6000:0000  to 
B000:7FFF.  Tlie  second  screen  page  goes  from  6000:8000  to  6000:FETT. 

Hercules  video  RAM 

The  Hocules  card's  video  RAM  in  text  mode  has  the  same  cursor  characm  and  port 
addresses  as  the  IBM  monochrome  display  adapter.  With  the  graphic  cigrabilities, 
only  a  few  bits  in  the  status  and  control  register  are  diffnent  from  the  monochrome 
card.  An  additional  configuration  register  can  be  addressed  from  3BFH.  You  can 
write  to  this  register  only.  Only  bits  0  and  1  are  of  interest  to  the  progrartuner. 
The  formo'  indicates  whether  the  grt^hic  mode  can  be  switched  on  (1)  or  not  (0). 
Bit  1  detomines  whether  the  second  display  page  can  be  used.  Bit  1  contains  the 
value  1  if  the  second  page  is  usable. 

To  avoid  conflicts  with  otho*  video  cards  (especially  color  cards),  both  bits  are  set 
to  0  at  the  start  of  the  system  so  that  ndther  grt^c  mode  nor  the  second  display 
page  are  accessible  at  Erst  Applicadon  programs  must  configure  the  Hercules 
display  ad^ter  through  the  configuration  register  if  the  programs  require  graphic 
mode  or  the  secoid  screen  page. 

The  control  register  of  the  Hercules  graphic  card  has  some  diff^nces  from  that  of 
the  MDA  discussed  in  the  preceding  section. 


7  654  321  Obit 
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Unlike  the  IBM  monochrome  display  adapter,  bit  0  is  unused  and  doesn't  have  to 
be  set  to  1  during  the  system  boot  Bit  1  detomines  text  or  graphic  mode:  a  0  in 
bit  1  enables  text  mode,  while  a  1  in  bit  1  enables  graphic  mode.  As  you  shall  see 
in  the  following  examples,  changing  these  bits  isn't  enough  to  switch  between 
text  and  gr^hic  modes.  The  internal  registers  of  the  684S  must  be  reset  as  well. 
During  this  process,  the  screen  display  must  be  switched  off  to  prevoit  the  6845 
from  creating  garbage  during  its  rqnogramming. 

The  Hercules  card  has  a  seventh  bit  in  this  regista.  Its  contents  determine  which  of 
the  two  screen  pages  appear  on  the  monitor  screen.  If  this  bit  is  0,  the  first  screen 
page  appears;  a  1  calls  the  second  screen  page  on  the  screoi.  Indepoident  of  each 
other,  the  user  can  write  to  or  read  from  either  page  at  any  time.  You  can  only 
write  to  this  register;  attempts  to  read  this  register  return  the  value  FFH.  Because 
of  this,  it  is  impossible  to  switch  off  the  display  simply  by  reading  the  contents  of 
the  status  register  and  erasing  bit  3,  regardless  of  the  display  mode  and  the  screen 
page  selected. 

7  6  5  4  3  2  1  0  bit 


l_ 

Horizontal 
synchronization 
signal:  0=off,  1=on 

OsCurrent  pixel  off 
isCurrent  pixel  on 

Vertical 

synchronization 
signal:  0=on,  i=off 

Hercules  status  register  (3BAH) 

Only  the  significance  of  bit  7  makes  this  register  different  from  the  IBM 
monochrome  card.  It's  always  set  to  0  when  the  6845  sends  a  vertical 
synchronization  signal  to  the  display.  This  signal  is  always  sent  when  the  last 
screen  line  has  been  constructed.  The  electron  beam,  which  constructs  the  display, 
then  jumps  to  the  first  line  of  the  screen  to  start  constructing  a  new  screen. 

Since  the  Hercules  card  uses  the  same  processor  as  the  IBM  card,  the  internal 
registers  of  the  6845  and  their  meaning  are  identical  to  the  IBM  card.  The  index 
register  and  data  register  are  also  located  at  the  same  address.  The  following  values 
must  be  assigned  to  the  various  registers  in  the  text  and  graphic  modes 
reqjectively: 
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No. 

Meaning 

Text 

Graphic 

0 

Horizontal  character  seeded 

97 

53 

1 

Horizontal  character  displayed 

80 

45 

2 

Horiz.  synchronization  signal  after-character 

82 

46 

3 

Horiz.  synchronization  signal  width 

15 

7 

4 

Vertical  character  seeded 

25 

99. 

5 

Vertical  character  justified 

6 

2 

6 

Vertical  character  displayed 

25 

87 

7 

Vert,  synchronization  signal  after...character 

25 

87 

8 

Interlace  mode 

2 

2 

_9 _ 

Number  of  ccan-lines  per  line 

13 

3 

10 

Starting  line  of  blinking  cursor 

11 

0 

11 

Ending  line  of  the  blinking  cursors 

12 

0 

12 

High  byte  of  screen  page  starting  address 

0 

0 

13 

Low  byte  of  screen  page  starting  address 

0 

0 

14 

High  byte  of  blinking  cursor  char,  address 

0 

0 

15 

Low  byte  of  blinking  cursor  char,  address 

0 

0 

16 

Reserved 

17 

Reserved 

As  mentioned  earlier,  the  Hercules  card  in  graphic  mode  provides  348x720 
resolution.  Every  pixel  on  the  screen  corresponds  to  one  bit  in  the  video  RAM.  If 
the  corresponding  bit  contains  the  value  1,  the  dot  is  visible  on  the  display, 
otherwise  it  remains  dark.  The  following  figure  shows  the  construction  of  the 
video  RAM  in  the  graphic  mode. 
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Line  1 

(90  bytes) 

+205A (h) 

Line  5 

(90  bytes) 

+20B4  (h) 

Line  9 

(90  bytes) 

• 

: 

+3D88(h) 

Line  337 

(90  bytes) 

+3DE2 (h) 

Line  341 

(90  bytes) 

+3E3C (h) 

Line  345 

(90  bytes) 

+3E96(h) 

unused 

(362  bytes) 

+4000 (h) 

Line  2 

(90  bytes) 

+405A (h) 

Line  6 

(90  bytes) 

+40B4  (h) 

: 

: 

Line  10 

(90  bytes) 

+5D88 (h) 

Line  338 

(90  bytes) 

+5DE2 (h) 

Line  342 

(90  bytes) 

+5E3C  (h) 

Line  346 

(90  bytes) 

+5E96(h) 

unused 

(362  bytes) 

+6000 (h) 

Line  3 

(90  bytes) 

+605A  (h) 

Line  7 

(90  bytes) 

+60B4  (h) 

Line  11 

(90  bytes) 

! 

+7D88 (h) 

Line  339 

(90  bytes) 

+7DE2  (h) 

Line  343 

(90  bytes) 

+7E3C  (h) 

Line  347 

(90  bytes) 

+7E96 (h) 

unused 

(362  bytes) 

RAM 


0000:0000 


+$000 (h) 


Video  RAM  and  the  screen  under  construction 

The  bit  patterns  of  the  individual  lines  in  the  video  RAM  aren't  arranged 
sequentially,  as  you  might  have  assumed.  The  32K  of  video  RAM  is  divided  into 
four  8K  blocks.  The  first  block  contains  the  bit  patt^  for  any  lines  divisible  by  4 
(0, 4,  8, 12,  etc.).  The  second  block  contains  the  bit  patterns  for  lines  1,  S,  9, 13 
etc.  The  third  block  contains  the  bit  patterns  fw  lines  2, 6, 10, 14,  etc.,  while  the 
last  block  contains  lines  3,  7,  11,  IS  etc.  When  the  6845  generates  a  display,  it 
obtains  information  for  screen  line  zero  from  the  first  data  block,  screen  line  one 
from  the  second  data  block,  etc.  After  it  has  obtained  the  contents  of  the  third 
screen  line  from  the  fourth  data  block,  it  accesses  the  first  data  block  again  for  the 
structure  of  the  fourth  line.  Each  line  requires  90  bytes  within  the  individual  data 
blocks — every  pixel  requires  a  bit,  and  720  pixels  divided  by  8  bits  (per  byte) 
equals  90.  The  first  90  bytes  in  the  first  memmy  area  provide  the  bit  pattern  for 
screen  line  zero,  and  the  90  bytes  following  provide  the  bit  patton  fix'  the  fourth 
screen  line.  The  zero  byte  of  one  of  these  90-byte  sets  represents  the  first  eight 
columns  of  a  screen  line  (columns  0-8).  The  first  l^te  represrats  columns  8- IS, 


485 


10.  Accessing  and  Programming  the  Video  Cards 


PC  System  Programming 


etc.  Within  one  of  these  bytes,  bit  7  corresponds  to  the  left  screen  pixel  and  bit  0 
corresponds  to  the  right  screen  pixel. 

RAM 


Relationship  between  90~line  bytes  and  screen  display 

If  the  screen  pixels  of  a  line  (0  to  719)  and  the  screen  pixels  of  a  column  (0  to 
347)  are  sequentially  numbered,  an  equation  indicates  the  address  of  the  bytes 
relative  to  the  beginning  of  the  screen  page.  This  address  contains  the  information 
for  a  pixel  with  the  coordinates  XfV. 

To  determine  the  bit  within  the  byte  which  represents  the  pixel,  the  following 
fmnula  can  be  used: 

Address  =  2000H  *  (Y  mod  4)  +  90  *  int(Y/4)  +  int (X/8) 

The  following  program  demonstrates  the  abilities  of  the  Hercules  display  ad2q)ter. 
The  individual  routines  within  this  program  have  some  differences  from  the 
routines  shown  in  the  monochrome  display  adapter  demo  program  from  the 
previous  section.  The  routines  here  enable  access  to  both  screen  pages,  and  support 
the  Hercules  gr2q)hic  mode. 

Assembler  listing:  VHERC.ASM 


*********************************************************************. 


.  * 

V  H  E  R  C 

•  * 

Task 

:  makes  a  basic  function  available  for 

★  • 
f 

.  ★ 

access  to  the  HERCULES  GRAPHICS  CARD 

★  • 
f 

r 

.  * 

Info 

:  all  functions  partition  the  screen  display 

f 

*  • 
f 

.  ★ 

into  columns  0-79  and  lines  0-24  (text  mode) 

*  • 

.  * 
r 

. 

&  columns  0-719  and  lines  0-347  (graphic  mode) 

*• 

f 

.  * 

Author 

;  MICHAEL  TISCHER 

★  • 
f 

•  * 
r 

developed  on 

:  8/11/87 

★  • 
f 
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last  update  :  6/15/89 


assembly  :  MASM  VHERC; 

LINK  VHERC; 


;*  call  :  VHERC  *; 

•  ********************************************************************* • 


;**  Constants 


CONTROL  REG 

- 

03B8h 

/Control  register  port  address 

ADDRESS  6845 

- 

03B4h 

/6845  address  register 

DATA_6845 

« 

03B5h 

/6845  data  register 

CONFIG  REG 

* 

03BFh 

/Configuration  register 

VIO  SEG 

- 

OBOOOh 

/Video  RAM  segment  address 

CUR  START 

10 

/Reg.  #  for  CRTC:  Start  cursor  line 

CUR  END 

11 

/Reg.  #  for  CRTC:  End  cursor  line 

CURPOS  HI 

* 

14 

/Reg.  #  for  CRTC:  Cursor  pos  hi  byte 

CURPOS_LO 

* 

15 

/Reg.  #  for  CRTC:  Cursor  pos  lo  byte 

DELAY 

- 

20000 

/Count  for  delay  loop 

;*=  Macros  ===»*» 


setmode  macro  modus 

mov  dx,  CC»JTROL_REG 
mov  a 1, modus 
out  dx, al 

endm 


;Set  control  register 

/Screen  control  register  address 
;Put  new  mode  in  AL  register 
;Send  mode  to  control  register 


setvk 


macro 


/Write  value  to  CRTC  registers 
/Input:  AL  *  register  number 
/  AH  =  Value  for  register 


/Index  register  address 
/Display  register  number  and  new  value 

endm 


mov  dx, ADDRESS_68  45 
out  dx, ax 


/=*  stack  ==**-===««=*===»= 
stack  segment  para  stack 

dw  256  dup  (?) 
stack  ends 

/»=  Data  ======«============ 


/Definition  of  stack  segment 
/Stack  is  256  words  in  size 
/End  of  stack  segment 


data  segment  para  'DATA*  /Define  data  segment 


/“=  Data  needed  for  demo  program 


initm 


strl 

str2 


db  13, 10, -VHERC  (c)  1987  by  Michael  Tischer-,13,10,13,10 

db  "This  demonstration  program  runs  only  with  - 

db  -  a  HERCULES-, 13, 10, -graphics  card.  If  your  PC  - 

db  -has  another  type  of  display  card,  -,13,10 

db  -please  input  an  >s<  to  stop  the  - 

db  -  program.-, 13, 10, -Otherwise  please  press  any  - 

db  -key  to  start  the  -,13,10 

db  -program  ...-,13,10,-$- 

db  1,17,16,2,7,0 
db  2,16,17,1,7,0 


domes  db  13, 10 

db  -This  program  creates  a  short  graphic  demo  -,13,10 
db  -and  a  text  demo.  Pressing  a  key  during  the-, 13, 10 
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db  "demo  ends  the  program. ",13,10 

db  "Press  a  key  to  start  the  program. 13, 10, "$" 

Table  of  line  offset  addresses  — 

lines  dw  0*160,1*160,2*160  /Beginning  addresses  of  the  lines  as 
dw  3*160,4*160,5*160  /offset  addresses  in  video  RAM 
dw  6*160,7*160,8*160 

dw  9*160,10*160,11*160,12*160,13*160,14*160,15*160,16*160 
dw  17*160, 18*160, 19*160, 20*160, 21*160,  22*160, 23*160, 24*160 


grafikt 

db  35h,  2Dh, 

2Eh, 

07h, 

5Bh, 

02h 

/Register  values 

for 

the 

db  57h,  57h, 

02h, 

03h, 

OOh, 

OOh 

/graphic  mode 

textt 

db  61h,  50h, 

52h, 

OFh, 

19h, 

06h 

/Register  values 

for 

the 

db  19h,  19h, 

02h, 

ODh, 

OBh, 

Och 

/text  mode 

data 

ends 

/End  of 

data 

segment 

/“*  Code  segment 

code  segment  para  *CCX)E'  /Definition  of  the  code  segment 

org  lOOh 
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inov 

cx,719 

; Horizontal  pixels 

grl: 

push 

cx 

;Push  horizontal  pixels  on  stack 

mov 

cx,  ax 

;Vertlcal  pixels  in  counter 

push 

ax 

;Push  vertical  pixels  on  stack 

gr2: 

call 

spix 

;Set  pixel 

Inc 

dx 

; Increment  line 

loop 

gr2 

;Draw  line 

pop 

ax 

;Get  vert,  pixels  frcxti  stack 

sub 

ax,  3 

;next  line  3  pixels  less 

pop 

cx 

;Get  horiz.  pixels  from  stack 

push 

cx 

; Store  horizontal  pixels 

push 

ax 

;Push  vertical  pixels  on  stack 

gr3: 

call 

spix 

;Set  pixel 

inc 

bx 

/Increment  column 

loop 

gr3 

/Draw  line 

pop 

ax 

/Get  vertical  pixels  from  stack 

pop 

cx 

/Get  horizontal  pixels  from  stack 

sub 

cx,  6 

/Next  line  6  pixels  less 

push 

cx 

/Record  horizontal  pixels 

mov 

cx,ax 

/Vertical  pixels  in  counter 

push 

ax 

/Note  vertical  pixels  on  stack 

gr4: 

call 

spix 

/ Set  pixel 

dec 

dx 

/Decrement  line 

loop 

gr4 

/Draw  line 

pop 

ax 

/Get  vertical  pixels  from  stack 

sub 

ax,  3 

/Next  line  3  pixels  less 

pop 

cx 

/Get  horizontal  pixels  from  stack 

push 

cx 

/Record  horizontal  pixels 

push 

ax 

/Record  vertical  pixels  on  stack 

gr5: 

call 

spix 

/Set  pixel 

dec 

bx 

/Increment  column 

loop 

gr5 

/Draw  line 

pop 

ax 

/Get  vertical  pixels  from  stack 

pop 

cx 

/Get  horizontal  pixels  from  stack 

sub 

cx,6 

/Next  line  6  pixels  less 

cmp 

ax,  5 

/Is  the  vertical  line  longer  than  5 

ja 

grl 

/YES  — >  continue 

xor 

ah,  ah 

/Wait  for  function  nr.  for  key 

int 

16h 

/Call  BIOS  keyboard  Interrupt 

; —  Initialize 

text  mode  - 

call 

text 

/Switch  on  text  mode 

mov 

cx, OdOOh 

/Switch  on  full  cursor 

call 

cdef 

call 

els 

/Clear  screen 

; —  Display  strings  in 

display  page  0  - 

xor 

bx,bx 

/Start  in  uK>er  left  display  corner 

call 

calo 

/Convert  to  offset  address 

mov 

si,  offset 

strl 

/Offset  address  of  stringl 

mov 

cx, 16*25 

/The  string  is  5  characters  long 

demol: 

call  print 

/Output  string 

loop  demol 

; —  Display  strings  in 

display  page  1  - 

inc 

bp 

/Process  display  page  1 

xor 

bx,bx 

/Start  in  the  upper  left  corner 

call 

calo 

/Convert  to  offset  address 

mov 

si,  offset 

str2 

/Offset  address  of  stringl 

mov 

cx, 16*25 

/string  is  5  characters  long 

deino2: 

call 

print 

/Output  string 

loop  demo2 

demo3: 

setmode  10001000b 

/Display  text  page  1 
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pause: 

mov  cx,  DELAY 
loop  pause 

setmode  00001000b 

/Load  counter 
/Count  to  65,536 

/Display  page  0 

r  • 

mov 

cx, DELAY 

/Load  counter 

pausel : 

loop 

pausel 

/Count  to  65,536 

mov 

ah,l 

/Test  function  nr.  for  key 

int 

16h 

/Call  BlOS-keyboard- Interrupt 

je 

d^o3 

/No  key  — >  continue 

xor 

ah,  ah 

/Get  function  number  for  key 

int 

16h 

/Call  BlOS-keyboard-Interrupt 

mov 

bp,0 

/Display  page  1 

call 

els 

/Clear  screen 

mov 

cx, ODOch 

/Restore  normal  cursor 

call 

edef 

call 

els 

/Clear  screen 

jmp 

ende 

/End  program 

demo 

endp 

;==  The  actual 

functions  follow 

CONFIG:  configures  the  HERCULES  card - 

; —  Input 

: 

AL  ;  bit  0  = 

0  :  Only  text  presentation  possible 

; — 

1  :  also  graphic  presentation  possible 

;  — 

bit  1  = 

0  :  RAM  for  display  page  2  off 

; — 

1  :  RAM  for  display  page  2  on 

—  Output  :  none 


/ —  Register  : 

AX  and  DX  are 

changed 

config 

proc 

near 

mov 

dx, CONFIG_REG 

/Address 

of  configuration  register 

out 

dx,al 

/Set  new 

value 

ret 

/Back  to 

caller 

config 

endp 

; —  TEXT:  switches  the  text  presentation  on  - 

; —  Input  :  none 
; —  Output  :  none 

; —  Register  :  AX  and  DX  are  changed 
text  proc  near 

mov  si, offset  textt  ;Offset  address  of  the  register-table 
mov  bl, 00100000b  ;Display  page  0,text  mode, blinking 

jmp  short  vcprog  ; Program  video-controller  again 

text  endp 

; —  GRAFIK:  switches  on  the  graphic  mode  - 

; —  Input  :  none 
; —  Output  :  none 

; —  Register  :  AX  and  DX  are  changed 
grafik  proc  near 

mov  si, offset  grafikt  ;Offset  address  of  the  register-table 
mov  bl, 00000010b  /Display  page  0,  graphic  mode 

grafik  endp 

; —  VCPROG:  programs  the  video  controller  - 

; —  Input  :  SI  =  address  of  a  register-table 
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BL  »  value  for  display-control-register 

—  Output  :  none 

—  register  :  AX,  SI,  BH,  DX  and  FLAGS  are  changed 


vcprog 

proc  near 

setmode  bl 

/Bit  3  «  0:  display  aus 

vcpl: 

mov  cx, 12 
xor  bh, bh 
lodsb 

mov  ah,  al 
mov  al,bh 
setvk 
inc  bh 
loop  vcpl 

/12  registers  are  set 
/Start  with  register  0 
/Get  register  value  from  the  table 
/Register  value  to  AH 
/Number  of  the  register  to  AL 
/Transmit  value  to  the  controller 
/Address  next  register 
/Set  additional  registers 

or  bl,  8 
setmode  bl 
ret 

/Bit  3*1:  display  on 
/Set  new  mode 
/Back  to  caller 

vcprog  endp 

; —  cDEF:  sets  the  start  and  end  line  of  the  cursor- 
; —  Input  ;  cL  »  start  line 
; —  cH  *  end  line 

; —  Output  :  none 
; —  register  :  AX  and  DX  are  changed 

cdef  proc  near 

mov  al,CUR_START 
mov  ah, cl 
setvk 

mov  al,CUR_END 
mov  ah, ch 
setvk 
ret 

cdef  endp 

; —  SETBLINK  :  sets  the  blinking  display  cursor  - 
; —  Input  :  DI  “  offset  address  of  the  cursor 
; —  Output  :  none 

; —  register  :  BX,  AX  and  DX  are  changed 

set blink  proc  near 

mov  bx, di 
mov  al,CURPOS_HI 
mov  ah, bh 
setvk 

mov  al,CURPOS_LO 
mov  ah, bl 
setvk 
ret 

set  blink  endp 

; —  GETVK  :  reads  a  byte  from  one  register  of  the  video- controller  - 

; —  Input  :  AL  *  number  of  the  register 

; —  Output  :  AL  *  content  of  the  register 

; —  register  :  DX  and  AL  are  changed 

getvk  proc  near 

mov  dx, ADDRESS_6845  ;Address  of  the  index  register 

out  dx,al  ;Send  number  of  the  register 

jmp  $+2  ; Short  lo  pause 

inc  dx  ;Address  of  the  index  register 


/Transmit  offset  to  BX 

/Register  15: Hi  Byte  of  cursor  offset 

/HI  byte  of  the  offset 

/Transmit  to  video-controller 

/Register  15:Lo-Byte  of  cursor  offset 

/Lo  byte  of  the  offset 

/Transmit  to  CRTC 


/Register  10:  start  line 

/Start  line  to  AH 

/Transmit  to  video-controller 

/Register  11:  Endline 

/End  line  to  AH 

/Transmit  to  video-controller 
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In  al,dx 
ret 


;Read  content  to  AL 
/Back  to  caller 


getvk 


endp 


SCROLLUp:  scrolls  a  window  by  N  lines  upward  - 

Input 


—  Info 


supl: 


; 

BL  -  line  upper  left 

BH  -  column 

upper 

left 

DL  “  line  lower  right 

DH  «=  column 

lower  right 

CL  -  number 

of  the  lines  to  be  scrolled 

BP  “  number  of  the  display  page  (0  or  1) 

none 

:er  : 

only  FLAGS  are  changed 

the  display  lines 

released  are  erased 

proc 

near 

cld 

/Increment  for  string  instructions 

push 

ax 

/Store  all  changed  registers 

push 

bx 

/on  the  stack 

push 

di 

/In  this  case  the  sequence 

push 

si 

/must  be  followed  ! 

push 

bx 

/These  three  registers  are  returned 

push 

cx 

/from  the  stack  before 

push 

dx 

/the  end  of  the  routine 

sub 

dl,bl 

/Calculate  number  of  lines 

inc 

dl 

/Deduct  number 

sub 

dl,cl 

/of  lines  to  be  scrolled 

sub 

dh,bh 

/Calculate  number  of  columns 

inc 

dh 

call 

calo 

/Convert  upper  left  in  offset 

njov 

si,di 

/Note  address  in  SI 

add 

bl,cl 

/First  line  in  scrolled  window 

call 

calo 

/Convert  first  line  in  offset 

xchg 

si,di 

/Exchange  SI  and  DI 

push 

ds 

/Store  segment  register 

push 

es 

/on  the  stack 

mov 

ax,VIO__SEG 

/Segment  address  of  the  video  RAM 

mov 

ds,ax 

/to  DS 

mov 

es,ax 

/and  ES 

mov 

ax,di 

/Note  DI  in  AX 

mov 

bx,  si 

/Note  SI  in  BX 

mov 

cl,dh 

/Number  of  columns  in  counter 

rep  movsw 

/Move  a  line 

mov 

di,ax 

/Restore  DI  from  AX 

mov 

si,bx 

/Restore  SI  from  BX 

add 

di,160 

/Set  next  line 

add 

si, 160 

dec 

dl 

/Processed  all  lines  ? 

jne 

supl 

/NO  — >  move  another  line 

pop 

es 

/Get  segment  register  from 

pop 

ds 

/stack 

pop 

dx 

/Get  lower  right  corner 

pop 

cx 

/Get  number  of  lines 

pop 

bx 

/Get  upper  left  corner 

mov 

bl,dl 

/Lower  line  to  BL 

sub 

bl,cl 

/Deduct  number  of  lines 

inc 

bl 

mov 

ah,07h 

/Color  :  black  on  white 

call 

clear 

/Erase  liberated  lines 

pop 

si 

/CX  and  DX  have  been  brought  back 

pop 

di 

/already 

pop 

bx 

pop 

ax 

ret 

/Back  to  caller 
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scrollup  endp 


—  SCROLLDN: 

—  Input 


—  Output 

—  register 

—  Info 


scroll  a  Window  by  N  lines  upwards  - 

BL  -  line  upper  left 

BH  -  column  upper  left 

DL  «  line  lower  right 

DH  *  column  lower  right 

CL  «  number  of  the  lines  to  be  scrolled 

BP  »  number  of  the  display  page  <0  or  1) 

none 

only  FLAGS  are  changed 
released  lines  are  deleted 


scrolldn 


sdnl : 


proc 

near 

cld 

push 

ax 

push 

bx 

push 

di 

push 

si 

push 

bx 

push 

CX 

push 

dx 

sub 

dh,bh 

inc 

dh 

mov 

al,bl 

mov 

bl,dl 

call 

calo 

mov 

si,di 

sub 

bl,cl 

call 

calo 

xchg 

si,di 

sub 

dl,al 

inc 

dl 

sub 

dl,cl 

push 

ds 

push 

es 

mov 

ax,VIO_SEG 

mov 

ds,ax 

mov 

es,ax 

mov 

ax,di 

mov 

bx,  si 

mov 

cl,dh 

rep  movsw 

mov 

dl,ax 

mov 

si,bx 

sub 

dl,160 

sub 

si, 160 

dec 

dl 

jne 

sdnl 

pop 

es 

pop 

ds 

pop 

dx 

pop 

CX 

pop 

bx 

mov 

dl,bl 

add 

dl,cl 

dec 

dl 

mov 

ah,07h 

call 

clear 

pop 

si 

pop 

di 

pop 

bx 

pop 

ax 

ret 

; Increment  on  string  Instructions 

\ 

; Secure  all  changed  registers  on  the 
; stack 

;In  this  case  the  sequence  must 
;be  followed! 

; These  three  registers  are 
/returned  from  the  stack  before  the 
/end  of  the  routine 

/Calculate  number  of  columns 

/Record  line  upper  left  in  AL 
/Line  lower  right  top  lower  left 
/Convert  upper  left  in  offset 
/Note  address  in  SI 
/Deduct  number  of  chars  to  scroll 
/Convert  upper  left  in  offset 
/Exchange  SI  and  DI 
/Calculate  number  of  lines 

/Deduct  number  of  lines  to  scroll 
/Store  segment  register  on  the 
/ stack 

/Segment  address  of  the  video  RAM 
/to  DS 
/and  ES 

/Record  DI  in  AX 

/Record  SI  in  BX 

/Number  of  columns  in  counter 

/Move  a  line 

/Restore  DI  fr^  AX 

/Restore  SI  from  BX 

/Set  next  line 

/All  lines  processed  ? 

/NO  — >  move  another  line 
/Get  segment  register  from 
/stack 

/Get  lower  right  corner 
/Get  number  of  lines 
/Get  upper  left  corner 
/Upper  line  to  DL 
/Add  number  of  lines 

/Color  :  black  on  white 
/Erase  liberated  lines 

/CX  and  DX  have  already 
/been  read 


/Back  to  caller 
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scrolldn  endp 

; —  cLS:  clear  the  whole  screen  - 

; —  Input  :  BP  *  number  of  the  display  page  (0  or  1) 

; —  Output  :  none 

; —  register  :  only  FLAGS  are  changed 
els  proc  near 

mov  ah, 07h  ;Color  is  white  on  black 

xor  bx,bx  ;Upper  left  is  (0/0) 

mov  dx, 4F18h  ;IjOwer  right  is  (79/24) 

; —  perform  clear  - 

els  endp 

; —  CLEAR:  fills  a  designated  display  area  with  space  character  - 

; —  Input  :  AH  =  Attribute/color 
; —  BL  =  line  upper  left 

; —  BH  =  column  upper  left 

; —  DL  *  line  lower  right 

; —  DH  -  column  lower  right 

; —  BP  »  number  of  the  display  page  (0  or  1) 

; —  Output  :  none 

; —  register  :  only  FLAGS  are  changed 
clear  proc  near 

cld  /Increment  on  string  instructions 

push  cx  /Secure  all  changed 

push  dx  /registers  on  the  stack 

push  si 

push  di 

push  es 


sub 

dl,bl 

/Calculate  number  of  lines 

inc 

dl 

sub 

dh,bh 

/Calculate  number  of  columns 

inc 

dh 

call 

calo 

/Offset  address  of  UK>er  left  comer 

mov 

cx,VIO_SEG 

/Segment  address  of  the  video  RAM 

mov 

es,  cx 

/to  ES 

xor 

ch,  ch 

/Hi  byte  of  the  counter  to  0 

mov 

al,-  - 

/Space  character 

mov 

sl,di 

/Note  DI  in  SI 

mov 

cl,dh 

/Number  of  columns  in  counter 

rep 

stosw 

/Store  space  character 

mov 

di,  si 

/Restore  DI  from  SI 

add 

di,160 

/Set  next  line 

dec 

dl 

/All  lines  processed  ? 

jne 

clearl 

/NO  — >  erase  another  line 

pop 

es 

/Get  secured  registers 

pop 

dl 

/from  the  stack 

pop 

si 

pop 

dx 

pop 

cx 

ret 

/Back  to  caller 

clear  endp 

/ —  PRINT:  outputs  a  string  on  the  display  - 

/ —  Input  :  AH  “  attribute/color 

/ —  DI  *  offset  address  of  the  first  character 

/ —  SI  *  offset  address  of  the  strings  to  DS 

/ —  BP  =  number  of  the  display  page  (0  or  1) 

/ —  Output  :  DI  points  behind  the  last  character  to  be  output 

/ —  register  ;  AL,  DI  and  FLAGS  are  changed 

/ —  Info  :  the  string  must  ne  terminated  with  NUL- character. 
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other  control  characters  are  not  recognized 


print 

proc 

near 

cld 

;IncrCTient  on  string  instructions 

push  si 

;SI,  DX  and  ES  to  the  stack 

push  es 

push  dx 

mov 

dx,VIO  SEG 

/First  segment  address  of  video  RAM 

mov 

es,dx 

;to  DX  and  then  to  ES 

jmp 

print 1 

;Get  first  character  from  string 

printO: 

stosw 

/Store  attribute  and  color  in  V-RAM 

print 1 : 

lodsb 

/Get  next  character  from  the  string 

or 

al,al 

/Is  it  NUL 

jne 

printO 

/NO  — >  output 

printe: 

pop 

dx 

/Get  SI,  DX  and  ES  from  stack  again 

pop 

es 

pop 

si 

ret 

/Back  to  caller 

print 

endp 

■  cALO: 

converts  line  and 

column  into  offset  address  - 

; —  Input 

: 

BL  =  line 

; — 

BH  *  column 

; — 

Bp  *  number  of  the  display  page  (0  or  1) 

; —  Output  : 

DI  *  offset  address 

; —  register  : 

DI  and  FLAGS 

are  changed 

calo 

proc 

near 

push 

ax 

/Record  AX  on  the  stack 

push 

bx 

/Record  BX  on  the  stack 

shl 

bx,  1 

/Column  and  line  times  2 

mov 

al,bh 

/Column  to  AL 

xor 

bh,bh 

/Hi  byte 

mov 

di, [llnes+bx] 

/Get  offset  address  of  the  line 

xor 

ah,  ah 

/Hi  byte  for  column  offset 

add 

di,ax 

/Add  lines-  and  column  offset 

or 

bp,  bp 

/Display  page  0? 

je 

caloe 

/YES  — >  address  ok 

add 

di,8000h 

/Add  32  KB  for  display  page  1 

caloe: 

pop 

bx 

/Get  BX  from  stack  again 

pop 

ax 

/Get  AX  from  the  stack  again 

ret 

/Back  to  caller 

calo  endp 


—  CGR:  clear  the  complete  graphic  screen  - 

—  Input  :  BP  »  number  of  the  display  page  (0  or  1) 

AL  »  OOH  :  erase  all  pixels 
FFH  :  set  all  pixels 

—  Output  :  none 

—  register  :  AH,  BX,  cX,  DI  and  FLAGS  are  changed 


proc 

near 

push 

es 

/Record  ES  on  the  stack 

cbw 

/Expand  AL  to  AH 

xor 

di,di 

/Offset  address  in  video  RAM 

mov 

bx,VIO_SEG 

/Segment  address  display  page 

or 

bp,  bp 

/Erase  page  1? 

je 

cgrl 

/NO  — >  erase  page  0 

add 

bx,0800h 

/Segment  address  display  page 
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cgrl: 

mov 

es,bx 

; Segment  address  to  segment  register 

mov 

cxr  4000h 

;A  page  is  16K-words 

rep 

stosw 

;Fill  page 

pop 

es 

;Get  ES  from  stack 

ret 

;Bac)c  to  caller 

cgr 

endp 

SPIX: 

sets 

a  pixel  in 

the  graphic  display  - 

; —  Input 

: 

BP  »  number 

of  the  display  page  {0  or  1) 

;  — 

BX  »  column 

(0  to  719) 

; — 

DX  -  line 

(0  to 

347) 

; —  Output  : 

none 

; —  register  : 

AX,  DI  and 

FLAGS 

are  changed 

splx 

proc 

near 

push  es 

; Store  ES  on  the  stack 

push  bx 

; Store  BX  on  the  stack 

push 

cx 

; Store  cX  on  the  stack 

push  dx 

/Store  DX  on  the  stack 

xor 

di,di 

/Offset  address  in  video  RAM 

mov 

cx,VIO_SEG 

/Segment  address  display  page  0 

or 

bp,  bp 

/Access  page  1  ? 

je 

spixl 

/NO  — >  access  page  0 

mov 

cx, oeooh 

/Segment  address  display  page  1 

spixl: 

mov 

es,  cx 

/Segment  address  in  segment  register 

mov 

ax,dx 

/Move  line  to  AX 

shr 

ax,  1 

/Shift  line  right  2  times 

shr 

ax,  1 

/This  divides  by  four 

mov 

cl,  90 

/The  factor  is  90 

mul 

cl 

/Multiply  line  by  90 

and 

dx, 11b 

/AND  all  bits  except  for  0  and  1 

mov 

cl,  3 

/3  shifts 

ror 

dx,  cl 

/Rotate  right  (*  2000H) 

mov 

di,bx 

/Column  to  DI 

mov 

cl,  3 

/3  shifts 

shr 

di,  cl 

/divide  by  8 

add 

dl,ax 

/+  90  *  int (line/4) 

add 

di,  dx 

/+  2000H  *  (line  mod  4) 

mov 

cl,  7 

/Maximum  of  7  moves 

and 

bx,7 

/Column  mod  8 

sub 

cl,bl 

/7  -  column  mod  8 

mov 

ah,l 

/Determine  bit  value  of  the  pixels 

shl 

ah,  cl 

mov 

al,es: [di] 

/Get  8  pixels 

or 

al,ah 

/Set  pixel 

mov 

es: [di] ,al 

/Write  8  pixels  / 

pop 

dx 

/Get  DX  from  stack 

pop 

cx 

/Get  cX  from  stack 

pop 

bx 

/Get  BX  from  stack 

pop 

es 

/Get  ES  from  stack 

ret 

/Back  to  caller 

splx 

• «  End  == 

endp 

code 

ends 

end 

demo 

/End  of  the  code  segment 
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The  IBM  Color/Graphics  Adapter  (CGA)  supports  two  text  inodes  and  three 
different  graphic  inodes.  Like  Ae  other  two  cards,  the  CGA  is  based  on  a  684S 
video  processor  and  is  equipped  with  16K  of  video  RAM  which  begins  at  address 
B800:0000. 

Text  modes 

Besides  the  normal  text  mode  of  25  lines  and  80  columns,  the  CGA  also  has  a  text 
mode  consisting  of  25  lines  and  40  columns.  This  40-column  mode  displays 
characters  twice  as  wide  as  normal  80-column  mode.  CGA  characters  are  displayed 
in  an  8x8  matrix,  which  results  in  a  less  distinct  display  than  monochrome  display 
adapter  text.  The  CGA's  video  RAM  assignment  is  almost  identical  to  that  of  the 
monochrome  card.  The  attribute  byte  is  different  from  that  of  the  monochrome 
display  ad^Mer. 

7  654  321  Obit 


Character  color 

Character  Intensity 
0=normal 
lahigh  Intensity 

Background  color 

Blinking 

0=off 

1=on _ 


ColorlGr(^>hics  Adapter  attribute  byte 

The  lower  four  bits  of  the  attribute  byte  indicate  one  of  the  16  available  colors. 
The  meanings  of  the  upp»  four  bits  depend  on  whether  blinking  is  active.  If  it  is 
active,  bits  4  to  6  indicate  the  background  color  (taken  from  one  of  the  first  eight 
colors  of  the  color  palette),  while  bit  7  determines  whether  or  not  the  characters 
blink.  If  blinking  is  disabled,  bits  4  to  7  indicate  the  background  color  (taken  from 
one  of  the  16  available  colors). 
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Decimal 

Hexadecimal 

Binary 

Color 

0 

0 

0000 

Black 

1 

1 

0001 

Blue 

2 

2 

0010 

Green 

3 

3 

0011 

Cyan 

4 

4 

0100 

Red 

5 

5 

0101 

Magenta 

6 

6 

0110 

Brown 

7 

7 

0111 

Light  gray 

8 

8 

1000 

Dark  gray 

9 

9 

1001 

Light  blue 

10 

A 

1010 

Light  green 

11 

B 

1011 

Light  cyan 

12 

C 

1100 

Light  red 

13 

D 

1101 

Light  magenta 

14 

E 

1110 

Yellow 

15 

F 

1111 

White 

ColorfGraphics  Adapter  color  palette 

Each  80x25  text  page  requires  4,000  bytes  of  video  RAM.  16K  allows  a  total  of 
four  text  pages.  The  first  display  page  starts  at  address  B800:0000,  the  second  at 
B800:1000,  the  third  at  B800:2000  and  the  last  at  B800:3000.  The  40x25  mode 
allows  storage  of  eight  display  pages,  because  each  display  page  only  requires 
2,000  bytes  in  this  mode.  The  first  display  page  starts  at  adi*ess  B800:0000,  the 
second  at  B800:0800,  the  third  at  B800:1000,  etc. 

Graphic  modes 

The  CGA  supports  three  different  graphic  modes,  of  which  only  two  are  usually 
used.  The  color-suppressed  mode  displays  160x100  pixels  with  16  colors.  The 
6845  supports  this  resolution,  but  the  rest  of  the  hardware  doesn't  offer  color- 
suppressed  mode  support.  The  remaining  two  graphic  modes  have  resolutions  of 
320x200  and  640x200  respectively.  The  320x200  resolution  permits  four-color 
graphics,  while  640x200  resolution  only  allows  two  colors. 

320x200  resolution 

The  CGA  uses  up  all  16K  of  its  video  RAM  for  displaying  a  graphic  in  320x200 
resolution  with  four  colors.  This  limits  the  user  to  one  graphic  page  at  a  time.  Of 
the  four  colors  permitted,  the  background  can  be  selected  from  the  16  available 
colors.  The  other  three  colors  originate  from  one  of  the  two  user-selected  color 
palettes,  which  contain  three  colors  each. 
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Palette  1:  Color  1;  Cyan 

Palette  2:  Color  1:  Green 

Color  2 :  Violet 

Color  2:  Red 

Color  3:  White 

Color  3:  Yellow 

Since  a  total  of  four  colors  are  available,  each  staeen  pixel  requires  two  bits.  Four 
bits  can  rqiresent  the  color  numbers  (0  to  3).  The  following  values  correspond  to 
the  various  co1(h^: 

0  (XKb)  =  freely  selectable  background  color 

1  01(b)  =  color  1  of  the  selected  palette 

2  10^)  =  color  2  of  the  selected  palette 

3  11^)  =  color  3  of  the  selected  palette 

The  video  RAM  assignment  in  this  mode  is  similar  to  that  of  the  Hercules  card 
during  graphic  display.  The  individual  graphic  lines  are  stored  in  two  different 
blocks  of  memory.  The  first  block,  which  logins  at  address  6800:0000,  contains 
the  even  lines  (0, 2, 4...);  the  second  block,  which  begins  at  B800:2(X)0,  contains 
odd  lines  (1,3,5). 


Line  0 

(80  Bytes) 

Line  2 

(80  Bytes) 

Line  4 

(80  Bytes) 

1 

Line  194 

(80  Bytes) 

Line  196 

(80  Bytes) 

Line  198 

(80  Bytes) 

unused 

(192  Bytes) 

Line  1 

(80  Bytes) 

■MU* 

Line  3 

(80  Bytes) 

Line  5 

(80  Bytes) 

^  ^  1 

^  +3®$0« 

Line  195 

(80  Bytes) 

Line  197 

(80  Bytes) 

Line  199 

(80  Bytes) 

4r3mm 

unused 

(192  Bytes) 

RAM 


Video  RAM  assignment  in  graphic  mode  (blocking) 

Each  graphic  line  within  the  two  blocks  requires  80  bytes,  since  the  320  pixels  in 
a  line  are  coded  into  four  pixels  to  a  byte.  The  first  byte  in  a  graphic  line  (an  80- 
byte  series)  corresponds  to  the  first  four  dots  of  the  graphic  on  the  screen.  Bits  7 
and  8  contain  the  color  information  for  the  leftmost  pixel,  while  bits  0  and  1 
contain  the  color  information  for  the  rightmost  pixel  of  the  byte. 
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Graphic  line  coding  in  320x200  resolution 

A  formula  can  be  derived  with  the  help  of  this  information  to  determine  the  byte  in 
video  RAM,  similar  to  the  Hercules  card.  This  byte  is  relative  to  the  starting 
address  of  the  screen  page,  which  contains  the  color  information  for  a  pixel.  The 
screen  column  (0 — ^319)  is  designated  as  X  and  the  screen  line  (0 — 199)  as  Y: 

Address  =  2000H  *  (Y  mod  2)  +  80  *  int (Y/2)  +  int(X/4) 

To  determine  the  number  of  the  two  bits  within  this  byte  which  represents  the 
pixel,  use  the  following  formula: 

Bit  number  =  6  -  2  *  (X  mod  4) 

For  example,  if  this  formula  returns  4,  this  means  that  the  color  information  for 
the  dot  is  coded  into  bits  4  and  S. 
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Graphic  line  coding  in  640x200  resolution 


640x200  resolution 

High-resolution  mode  with  a  resolution  of  640x200  dots  only  allows  the  use  of 
two  colors.  The  video  RAM  assignment  in  this  mode  is  similar  to  320x200  mode. 
Each  line  displays  twice  as  many  pixels,  with  one  bit  encoding  the  line  instead  of 
2  bits.  Because  of  this,  one  screen  line  requires  880  bytes.  Therefore  the  formulas 
for  access  to  a  screen  pixel  are  similar. 

Address  =  2000H  *  (Y  mod  2)  +  80  *  int(Y/2)  +  int(X/8) 

Bit  number  =  7  -  (X  mod  8) 


CGA  registers 

The  CGA  has  a  mode  selection  register  at  address  3D8H  which  is  comparable  with 
the  control  register  of  the  monochrome  display  adapter.  You  can  write  to  this 
register  but  not  read  it. 
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7654  3210  bit _ 

0x40x25  characters 

1x80x25  characters _ 

Oxtext  mode 

i1xgraphlc  mode  (320x200) 

Oxcolor  display 
Ixmonochrome  display 
Oxscreen  off 

Ixgraphic  mode  (640x200) 
Oxbright  background 
Ixblinking  background 

unused 


Mode  selection  register 


Bit  layout 

Bit  0  of  this  register  determines  the  text  mode  display  of  80  or  40  columns  per 
line.  A  1  in  bit  0  displays  80  columns,  while  a  0  in  bit  0  displays  40  columns. 

The  status  of  bit  1  switches  the  CGA  from  text  mode  to  the  320x200  bit-mapped 
graphic  mode.  A  1  in  this  register  selects  graphic  mode,  while  a  0  selects  text 
mode. 

Bit  2  should  be  of  interest  to  any  users  who  want  to  operate  their  CGA  with  a 
monochrome  monitor.  If  this  bit  contains  the  value  1,  the  6845  suppresses  the 
color  signal,  displaying  monochrome  mode  only. 

Bit  3  is  responsible  for  creating  screens.  If  it  contains  the  value  0,  the  screen 
remains  black.  This  suppression  is  useful  when  changing  between  display  modes; 
it  prevents  sudden  signals  from  reaching  the  monitor  which  could  cause  damage. 

Bit  4  enables  and  disables  640x200  bitmt^ped  graphic  mode.  A  1  in  bit  4  enables 
this  mode,  while  a  0  disables  it 

Bit  S  has  the  same  signiflcance  as  in  the  monochrome  card.  If  it  contains  a  0, 
blinking  stops  and  bit  7  returns  one  of  the  16  available  background  colors.  This 
bit  contains  a  default  value  of  1,  which  causes  blinking  charactos. 

The  various  text  or  graphic  modes  and  the  color  or  monochrome  display  can  be 
selected  in  these  modes  with  this  register.  Bits  0, 1, 2  and  4  are  used  for  this.  The 
following  table  shows  how  these  bits  must  be  programmed  to  obtain  certain 
modes: 
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Bit  4 

Bit  2 

Bit  1 

Bit  0 

Result 

0 

1 

0 

0 

40x25  text  monochrorne 

0 

0 

0 

0 

40x25  text  color 

0 

1 

0 

1 

0 

0 

0 

1 

80x25  text  color 

0 

1 

1 

0 

320x200  graphic  monochrome 

0 

0 

1 

0 

320x200  graphic  color 

1 

1 

1 

0 

640x200  graphic  monochrome 

The  CGA  also  has  a  status  register  similar  to  the  status  register  in  the 
monochrome  display  adapter.  The  following  figure  shows  the  construction  of  this 
register,  which  can  found  at  address  3DAH.  It  is  a  read-only  register. 
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Ismemory  access  possible 
without  disturbing 

screen  contents _ 

isvideo  access  triggered 

Osvideo  access  on 
isvideo  access  off _ 

iselectronic  signal 
transmitted  In 
vertical  direction 


Status  register  structure 

Bit  0  of  this  registo'  always  contains  the  value  1  when  the  6845  sends  a  horizontal 
synchronizaticm  signal  to  the  monitor.  This  signal  is  transmitted  when  the  creation 
of  a  line  ends  and  the  CRTs  electron  beam  reaches  the  end  (tf  the  screen  line.  The 
electron  beam  then  jumps  back  to  the  left  comm*  of  the  screen  line.  Ihe  bit  gets  its 
significance  from  the  cmidition  that  the  CGA  doesn't  always  allow  data  reading  or 
writing  within  video  RAM. 

Flickering  and  the  CGA 

This  problem  occurs  because  the  6845  must  continuously  access  video  RAM  to 
read  its  contents  for  screen  display.  If  a  program  trie&  to  transmit  data  to  video 
RAM,  problems  can  arise  when  the  6845  accesses  video  RAM  at  the  same  time. 
The  result  of  this  memory  collision  is  an  occasional  flickering  on  the  screen. 

To  avoid  this  problem,  you  should  only  access  video  RAM  when  the  6845  is  not 
accessing  it  This  only  occurs  when  a  horizontal  synchronization  signal  travels  to 
the  screen,  because  it  requires  a  moment  of  time  until  the  electron  beam  has  carried 
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out  this  instruction.  For  this  reason,  the  status  register  must  be  read  before  every 
video  RAM  access  on  a  CGA.  This  process  must  be  repeated  until  bit  0  contains 
the  value  1.  When  this  happens,  a  maximum  of  two  bytes  can  then  be  transmitted 
to  video  RAM. 

Demonstration  program 

The  program  at  the  end  of  this  section  demonstrates  how  this  process  functions. 
This  delay  in  video  RAM  access  doesn't  occur  with  monochrome  cards  because 
they  are  equipped  with  special  hardware  logic  and  fast  RAM  chips.  This  is  also 
true  of  most  of  the  newer  model  color  cards.  Before  waiting  for  the  horizontal 
synchronization  signal,  which  results  in  an  enormous  delay  of  the  display  output, 
the  user  should  try  direct  access  to  vi(ko  RAM  to  test  his  color  card's  reaction 
time. 

If  many  accesses  to  video  RAM  occur  within  a  short  period  of  time  (e.g.,  scrolling 
the  screen),  the  electron  beam  doesn't  respond  fast  enough.  The  screen  should  be 
switched  off  using  bit  3  of  the  mode  selection  register.  This  prevents  the  6845 
from  accessing  video  RAM,  permitting  unlimited  user  access  to  video  RAM. 
When  data  transfer  ends,  the  screen  can  be  switched  on  again.  BIOS  uses  this 
method  during  soolling,  which  results  in  the  flickering  "silent  movie  effect." 

Color  selection  register 

The  color  selection  register  is  located  at  address  3D9H.  This  register  is  write-only 
(cannot  be  read). 


Color  selection  register 

The  meanings  of  individual  bits  in  this  register  depend  on  the  display  mode.  Text 
mode  uses  the  lowest  four  bits  for  assigning  the  background  color  from  the  16 
available  colors.  In  320x200  graphic  mode,  these  four  bits  indicate  the  color  of  all 
pixels  represented  by  the  bit  combination  00(b)  (background  color). 
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Bit  5  selects  the  color  palette  for  320x200  mode.  If  this  bit  contains  the  value  1, 
the  first  color  palette  (cyan,  violet,  white)  is  selected.  A  value  of  0  selects  the 
second  color  palette  (green,  yellow,  red). 

Internal  registers 

The  18  internal  registers  of  the  6845  on  this  card  are  accessed  exactly  like  the 
monochrome  card.  The  only  difference  is  that  the  index  and  the  data  register  are 
located  at  3D4H  and  3D5H.  The  following  table  shows  the  contents  which  the 
register  must  have  for  various  display  modes. 


ITgp 

Meaning 

Textl 

Text2 

0 

Horiz.  characters  seeded 

56 

113 

56 

1 

Horiz.  characters  displayed 

40 

80 

40 

2 

Horiz.  synchronization  signal  to 
....  Characters 

45 

90 

45 

3 

Horiz.  synchronization  signal 
in  characters 

10 

10 

10 

Vert,  characters  seeded 

31 

31 

127 

m 

6 

6 

6 

6 

Vert,  characters  displayed 

25 

25 

100 

7 

Vert,  synchronization  signal  to 
...  characters 

28 

28 

112 

m 

Interlace  mode 

2 

2 

2 

Number  of  scan-lines  per  line 

7 

7 

1 

m 

Starting  line  of  blinking  cursor 

6 

6 

6 

Ea 

Ending  line  of  blinking  cursor 

7 

7 

7 

ES 

0 

0 

0 

ES 

0 

0 

0 

EEI 

Cusrsor  character  address  (high  byte) 

0 

0 

0 

ES 

Cursor  character  address  (low  byte) 

0 

0 

0 

Ea 

Reserved 

Ea 

Reserved 

These  registers  are  of  interest  to  the  user  since  they  define  the  position  and 
appearance  of  the  cursor  on  the  screen.  Section  10. 1  described  programming  these 
registers.  The  CGA  adds  registers  12  and  /i3.  They  indicate  the  start  of  the  video 
page  which  must  be  displayed  on  the  screen,  as  offset  of  the  beginning  of  the  16K 
RAM  on  the  card  (B800:0000),  divided  by  2.  Register  12  contains  the  most 
significant  8  bits  of  this  offset,  while  register  13  contains  t))e  least  significant  8 
bits.  Normally  both  registers  contain  the  value  0,  displaying  the  first  screen  page 
(beginning  at  the  address  B800:0000)  on  the  screen.  For  display  of  the  first  screen 
page,  which  begins  at  location  B800:1000  in  the  80x25  text  mode,  the  value 
lOOOH  divided  by  2  (800H)  must  be  entered  in  both  registers. 

The  last  of  the  three  programs  in  this  chapter  accesses  the  color/graphics  adapts. 
The  only  significant  difference  between  the  two  preceding  programs  lies  in  the  fact 
that  the  video  controller  can  synchronize  video  RAM  access  and  screen 
construction.  This  is  necessary  on  all  video  cards  where  direct  access  to  video 
RAM  causes  a  flickering  on  the  screen.  The  WAIT  constant,  deflned  directly  after 
the  program  header,  switches  synchronization  on  or  off.  Its  contents  decide  during 


505 


JO.  Accessing  and  Programming  the  Video  Cards 


PC  System  Programming 


the  assembly  of  the  program,  whether  to  assemble  the  program  lines  for 
synchronization  listed  in  the  source  listing.  These  lines  would  slow  down  the 
screen  considoably,  and  should  only  be  included  if  it  is  absolutely  necessary. 

Assembler  listing:  VCOL.ASM 


Task 


Makes  some  basic  functions  available  for 
access  to  the  Color  Graphics  Adapter  (CGA) 


Info 


All  functions  subdivide  the  screen  *; 
Into  columns  0  to  79  and  lines  0  to  24  *; 
In  text  mode  and  Into  colimins  0  to  719  and  *; 
the  lines  0  to  347  In  graphic  mode.  *; 
the  40  column  text  mode  Is  not  supported  !  *; 
A  high  resolution  graphic  screen  should  appear*; 
first,  followed  by  a  text  screen.  If  the  high  *; 
res  screen  doesn't  appear,  try  running  the  *; 
program  a  few  times  In  succession.  *; 


* 

Author 

:  MICHAEL  TISCHER 

* 

* 

Developed  on 

:  8/13/87 

★ 

* 

★_ 

Last  update 

:  6/16/89 

* 

_★ 

★ 

assembly 

:  MASM  VCOL  (program  will  assemble  with  one 

* 

* 

warning  -  It  WILL  link  &  run) 

* 

★ 

LINK  VCOL; 

* 

_ _  ___  ^  _ ^ _ »»»  — — 

;*  Call  :  VCOL  *; 

•  **-k***1t*-k**-k-k*-lflflfk***ifk-k*-k***ifk*ifk***-k*ifk-k*  ********  ******************* 


;==  Constants 


CONTROL  REG 

03D8h 

/Control  register  port  address 

CCHOICE  REG 

» 

03D9h 

/Color  select  register  port  address 

ADDRESS  6845 

03D4h 

;6845  address  register 

DATA  6845 

03D5h 

;6845  data  register 

VIO_SEG 

* 

0B800h 

/Video  RAM  segment  address 

CUR  START 

10 

/Reg  #  for  CRTC:  Cursor  start  line 

CUR  END 

* 

11 

/Reg  #  for  CTRC:  Cursor  end  line 

CURPG  HI 

* 

12 

/Page  address  (high  l:^e) 

CURPG  LO 

- 

13 

/Page  address  (low  ):^e) 

CURPOS  HI 

14 

/Reg  #  for  CRTC;  Cursor  pos  high  byte 

CURPOS  LO 

15 

/Reg  #  for  CRTC:  Cursor  pos  low  l:^e 

DELAY 

20000 

/Counter  for  delay  loop 

;=»  Macros 


; —  SETMODE  ;  Macro  for  configuring  screen  control  register  - 

setmode  macro  modus 


mov  dx,  CC»ITROL_REG 
mov  al,  modus 
out  dx,al 

endm 


/Address  of  the  display  control  register 
;New  mode  Into  the  AL  register 
;Send  mode  to  control  register 


; —  WAITRET:  waits  until  display  Is  completed 


waltret 

macro 

local 

wrl 

/Local  label 

mov  dx, 3DAh 

/Address  of  the  display  status  register 

wrl: 

In  al,dx 

/Get  content 
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local 

wrl  ; 

r Local  label 

wrl: 

mov  dx,3DAh  ; 

in  al,dx  ; 

test  al,8  , 

je  wrl  ; 

^Address  of  the  display  status  register 
rGet  content 
^Vertical  retrace? 
rNO  — >  wait 

•  siK  a 

endm 

S  dUdCJi 

stack 

segment  para  stack  i 

r Definition  of  stack  segment 

dw  256  dup  (?)  i 

? 256-word  stack 

stack 

ends  ; 

;End  of  stack  segment 

data 

segment  para  'DATA'  , 

^Definition  of  data  segment 

reguired  for  demo  program 

initm 

db  13,10 

db  "VCOL  (c)  1988,1989  by  Michael  Tischer 
db  13,10,13,10 

db  "This  demo  program  only  runs  with  a  Color/Graphics'*,13,10 
db  “Adapter  (  CGA  ).  If  your  PC  uses  another  type  of,  13, 10 
db  “video  card  press  the  <s>  key  to  stop  the  program. “,13,10 
db  “Press  any  other  key  to  start  the  program. . .“,13,10,“$“ 

strl  db  1,0 

;»»  Table  of  offset  addresses  of  line  beginnings 

lines  dw  0*160,  1*160,  2*160  ; start  addresses  of  the  lines  as 

dw  3*160,  4*160,  5*160  ;ofrset  addresses  in  the  video  RAM 
dw  6*160,  7*160,  8*160 

dw  9*160, 10*160, 11*160, 12*160, 13*160, 14*160, 15*160, 16*160 
dw  17*160,18*160,19*160,20*160,21*160,22*160,23*160,24*160 


graphict 

db 

38h, 

28h, 

2Dh, 

OAh, 

7Fh, 

06h 

/register  values 

for 

the 

db 

64h, 

70h, 

02h, 

Olh, 

06h, 

07h 

; graph! c-modes 

textt 

db 

71h, 

50h, 

5Ah, 

OAh, 

IFh, 

06h 

; regi st er-va lues 

for 

the 

db 

19h, 

ICh, 

02h,  07h, 

06h, 

07h 

; graph! c-raodes 

wait  db  0  ;TRUE  (<>0)  when  caller  uses  the 

;/F  switch 


data  ends  ;End  of  data  segment 

code  segment  para  'CODE*  ;Definition  of  the  CCX)E  segment 

assume  cs:code,  ds:data,  es:data,  ss: stack 
;==  This  is  only  the  Demo-Program 
demo  proc  far 

; —  Look  for  /F  from  DOS  prcxnpt - 

mov  cl,ds:128  ;Get  number  of  bytes  from  pratpt 

or  cl, cl  ;No  parameters  given? 

je  switchl  ;NO  — >  Ignore 

mov  bx,129  ;BX  points  to  first  byte  in  pronpt 

mov  ch,bh  ;Set  loop  high  byte  to  0 

switch:  cmp  [bx],“F/“  ;Switch  in  this  position? 
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switchl: 


ende: 

startdemo 


grl: 

gr2: 


gr3: 


gr4: 


gr5: 


je 

switchl 

;yES  — >  Switch  found 

cmp 

[bx],"f/- 

; Switch  in  this  position? 

je 

switchl 

;YES  — >  Switch  found 

Inc 

bl 

;Set  BX  to  next  character 

loop  switch 

; Check  next  character 

roov 

ax, data 

;Get  segment  addr.  of  data  segment 

mov 

ds,  ax 

;and  load  into  DS 

mov  es,ax 

;and  ES 

mov 

wait, cl 

;Set  WAIT  flag 

; —  Display  init  message  and  wait  for  input  - 

mov 

ah,  9 

; Function  number  for  string  display 

mov 

dx, offset  initm 

/Address  of  intial  message 

int 

21h 

/Call  DOS  interrupt  21H 

xor 

ah,  ah 

/Function  number:  get  key 

int 

16h 

/Call  BIOS  keyboard  interrupt 

anp 

al,-s'* 

/<s>  key  pressed? 

je 

ende 

/YES  — >  End  program 

crop 

al,-S- 

/<S>  key  pressed? 

jne 

startdemo 

/NO  — >  Start  demo 

mov 

ax, 4C00h 

/Function  number:  End  program 

int 

21h 

/Call  DOS  interrupt  21H 

label  near 

call 

grafhi 

/switch  on  320*200  pixel  graphic 

xor 

al,al 

call 

cgr 

/Clear  graphic  display 

xor 

bx,bx 

/Column  0 

xor 

dx,dx 

/Line  0 

mov 

ax, 199 

/Pixels-vertical 

mov 

cx, 639 

/Pixels-horizontal 

push 

cx 

/Record  horizontal  pixels 

mov 

cx,  ax 

/Vertical  pixels  to  counter 

push 

ax 

/Record  vertical  pixels  on  the  stack 

mov 

al,l 

call 

pixhi 

/Set  pixel 

inc 

dx 

/Increment  line 

loop 

gr2 

/Draw  line 

pop 

ax 

/Get  vertical  pixels  from  the  stack 

sub 

ax,  3 

/Next  line  3  pixels  less 

pop 

cx 

/Get  horizontal  pixels  from  the  stack 

push 

cx 

/Record  horizontal  pixels 

push 

ax 

/Record  vertical  pixels  on  the  stack 

mov 

al,l 

call 

pixhi 

/Set  pixel 

inc 

bx 

/Increment  column 

loop 

gr3 

/Draw  line 

pop 

ax 

/Get  vertical  pixels  from  stack 

pop 

cx 

/Get  horizontal  pixels  from  stack 

sub 

cx,  6 

/Next  line  6  pixels  less 

push 

cx 

/Record  horizontal  pixels 

mov 

cx,ax 

/Vertical  pixels  to  counter 

push 

ax 

/Record  vertical  pixels  on  the  stack 

mov 

al,l 

call 

pixhi 

/Set  pixel 

dec 

dx 

/Decrement  line 

loop 

gr4 

/Draw  line 

pop 

ax 

/Get  vertical  pixels  from  stack 

sub 

ax,  3 

/Next  line  3  pixels  less 

pop 

cx 

/Get  horizontal  pixels  from  stack 

push 

cx 

/Record  horizontal  pixels 

push 

ax 

/Record  vertical  pixels  on  the  stack 

mov 

al,l 

call 

pixhi 

/Set  pixel 
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dec  bx 
loop  gr5 
pop  ax 
pop  cx 
sub  cx,  6 
cnp  ax,  5 
ja  grl 

xor  ah,  ah 
Int  16h 

call  text 
xor  bp, bp 

demol:  mov  al,30h 

or  ax, bp 
mov  strl,al 
call  set col 
call  setpage 
call  els 
xor  bx,bx 
call  calo 
mov  cx, 2000 
xor  ah, ah 
mov  si, offset  strl 

demo2:  Inc  ah 

call  print 
loop  deino2 

xor  ah,  ah 
int  16h 
Inc 

anp  1:^,4 
jne  danol 

xor  bp,  bp 
call  setpage 
jmp  ende 

d^o  endp 

;««  The  actual  functions  follow 


; Increment  column 
;Draw  line 

;Get  vertical  pixels  from  the  stack 
;Get  horizontal  pixels  from  the  stack 
;Next  line  6  pixels  less 
;Is  the  vertical  line  longer  than  5 
/YES — >  continue 

;Wait  for  function  number  of  key  wait 
/Call  BIOS  keyboard  interrupt 

/Switch  on  80x25  character  text  mode 
/Process  screen  page  0  first 
/ASCII  code  -0" 

/Convert  page  number  to  ASCII 
/Store  in  string 
/Set  color 

/Activate  screen  page  in  BP 

/Clear  screen  page 

/Begin  in  the  upper  left 

/Screen  comer  with  output 

/A  page  contains  2,000  characters 

/Start  with  color  code  0 

/Offset  address  of  string  1 

/Increment  color  value 

/Output  string  1 

/Repeat  until  screen  is  full 

/Wait  for  key 

/Call  BIOS- Keyboard-Interrupt 
/Increment  page  number 
/All  4  pages  processed  ? 

/NO  — >  then  next  page 

/Activate  page  0  again 


/Goto  program  end 


/ —  TEIXT:  switches  the  text  display  on - 

/ —  Input  :  none 
/ —  Output  :  none 

/ —  Register  :  AX,  SI,  BH,  DX  and  FLAGS  are  changed 
text  proc  near 

mov  si, offset  textt  /Offset  address  of  the  register-table 

mov  bl, 00100001b  / 80x25  text  mode, blinking 

jnp  short  veprog  /Program  video  controller  again 

text  endp 

/ —  GRAFHI:  switches  the  640*200  pixel  graphic  mode  on  - 

/ —  Input  :  none 
/ —  Output  :  none 

/ —  Register  :  AX,  SI,  BH,  DX  and  FLAGS  are  changed 
grafhi  proc  near 

mov  bl, 00010010b  /Graphic  mode  with  640*200  pixels 

jmp  short  graphic  /Program  video  controller  again 

grafhi  endp 

/ —  GRAFLO:  switches  the  320*200  pixel  graphic  mode  on  - 

/ —  Input  :  none 
/ —  Output  :  none 

/ —  Register  :  AX,  SI,  BH,  DX  and  FLAGS  are  changed 
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graflo 

proc  near 

graphic: 

mov  bl, 00100010b 
mov  si, offset  graphict 

/Graphic  mode  with  320*200  pixels 
/Offset  address  of  the  register  table 

graflo 

endp 

—  VCPROG;  programs  the  video  controller  - 

—  Input  :  SI  «  Address  of  a  register  table 

BL  “  Value  for  display  control  register 

—  Output  :  none 

—  Register  :  AX,  SI,  BH,  DX  and  FLAGS  are  changed 


vcprog  proc  near 

setmode  bl 

mov  cx,12 
xor  bh, bh 
vcpl :  lodsb 

mov  ah, al 
mov  al,bh 
call  setvk 
inc  bh 
loop  vcpl 

or  bl,8 
setmode  bl 
ret 

vcprog  endp 


;Bit  3-0:  screen  off 

;12  registers  are  set 
/Start  with  register  0 
/Get  register  value  from  table 
/Register  value  to  AH 
/Number  of  the  register  to  AL 
/Transmit  value  to  controller 
/Address  next  register 
/Set  additional  registers 

/Bit  3=1:  screen  on 
/Set  new  mode 
/Back  to  caller 


—  SETCOL 

—  Input 

—  Output 

—  register 

—  Info 


Sets  the  color  of  the  display  frame  and  Background  - 

AL  =  color  value 
none 

AX  and  DX  are  changed 

in  text  mode  the  lowest  4  bits  indicate  the  frame  color 
in  graphic  mode  the  lowest  4  bits  indicate  the  frame 
and  background  color,  bit  5  selects  the  color  palette 


set col  proc  near 

mov  dx , CCHOI CE_REG 

out  dx,  al 

ret 


/Address  of  the  color  selection  register 
/Output  color  value 
/Back  to  caller 


set col  endp 


/ —  CDEF  :  sets  the  start  and  end  line  of  the  cursor 
/ —  Input  :  CL  =  start  line 
/ —  CH  -  end  line 

/ —  Output  :  none 
/ —  register  :  AX  and  DX  are  changed 

cdef  proc  near 

mov  al,CUR_START 
mov  ah, cl 
call  setvk 
mov  al,CUR_END 
mov  ah,  ch 
jmp  short  setvk 

cdef  endp 

/ —  SETPAGE  :  sets  the  screen  page  - 

/ —  Input  :  BP  =  Number  of  the  screen  page  (0  to  3) 

/ —  Output  :  none 

/ —  register  :  BX,  AX,  CX  and  DX  are  changed 


/Register  10:  start  line 

/Start  line  to  AH 

/Transmit  to  video  controller 

/Register  11:  end  line 

/End  line  to  AH 

/Trananit  to  video  controller 
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; —  Info  :  in  the  Graphic  inodes  the  first  screen  page  has  the 
; —  number  0,  the  second  the  number  2 

setpage  proc  near 

mov  bx,!:^ 
mov  cl, 5 
ror  bx, cl 
mov  al , CURPG_HI 
mov  ah,bh 
call  setvk 
mov  al , CURPG_LO 
mov  ah, bl 
jmp  short  setvk 

setpage  endp 

; —  SETBLINK  :  sets  the  blinking  cursor  - 

; —  Input  :  DI  “  Offset  address  of  the  cursor 
; —  Output  :  none 

; —  register  :  BX,  AX  and  DX  are  changed 
set blink  proc  near 

mov  bx,di  /Move  offset  to  BX 

mov  al,CURPOS_HI  ;Hi  byte  of  the  cursor  offset 

mov  ah,bh  ;HI  byte  of  the  offset 

call  setvk  /Transmit  to  video  controller 

mov  al,CURPOS_LO  /Lo  byte  of  the  cursor  offset 

mov  ah,bl  /Lo  byte  of  the  offset 

/—  SETVK  is  called  automatically - 

setblink  endp 

/ —  SETVK  :  sets  a  byte  in  one  register  of  the  video  controller  - 

/ —  Input  :  AL  =  Number  of  the  register 

/ —  AH  =  new  content  of  the  register 

/ —  Output  :  none 
/ —  register  :  DX  and  AL  are  changed 

setvk  proc  near 

mov  dx,ADDRESS_6845 
out  dx, al 
jmp  short  $+2 
inc  dx 
mov  al,ah 
out  dx,al 
ret 

setvk  endp 

/ —  GETVK  :  gets  a  byte  from  one  register  of  the  video  controller  - 

/ —  Input  ;  AL  =  Number  of  the  register 

/ —  Output  :  AL  =  Contents  of  register 

/ —  register  :  DX  and  AL  are  changed 

getvk  proc  near 

mov  dx,ADDRESS_6845 
out  dx, al 
inc  dx 

jmp  short  $+2 
in  al,dx 
ret 

getvk  endp 

/ —  SCROLLUP:  scrolls  a  window  N  lines  upward 


/Address  of  the  index  register 
/Send  number  of  the  register 
/Index  register  address 
/Short  io  pause 
/Set  new  contents 
/Back  to  caller 


/Address  of  the  index  register 

/Send  number  of  the  register 

/Short  I/O  pause 

/Address  of  the  index  register 

/Content  to  AL 

/Set  new  content 

/Back  to  caller 


/Screen  page  to  BX 
/Multiply  by  2,048 

/Register  12:  Hi  byte  page  address 
/Hi  byte  of  the  screen  page  to  AH 
/Transmit  to  video  controller 
/Register  13:  Lo  byte  page  address 
/Lo  byte  of  the  screen  page  to  AH 
/Transmit  to  video  controller 


511 


10,  Accessing  and  Programming  the  Video  Cards 


PC  System  Programming 


; —  Input 

: 

BL  *  line  upper  left 

; — 

BH  -  column  u^per 

left 

; — 

DL  «  line  below  right 

; — 

DH  »  column  below  right 

; — 

CL  «  Number  of  lines,  to  be  scrolled 

; — 

: 

BP  -  Number  of  the  screen  page  (0  to  3) 

; —  Output  : 

none 

; —  register  : 

only  FLAGS  are  changed 

; —  Info 

: 

the  display  lines 

liberated  are  cleared 

scrollup 

proc 

near 

old 

;On  string  cwiinands  count  up 

push 

ax 

;A11  changed  registers  to  the 

push 

bx 

; Secure  stack 

push 

di 

;In  this  case  the  sequence 

push 

si 

;must  be  observed  ! 

push 

bx 

; These  three  registers  are  returned 

push 

cx 

/before  the  end  of  the  routine 

push 

dx 

;Frcan  the  stack 

sub 

dl,bl 

/Calculate  the  number  of  lines 

Inc 

dl 

sub 

dl,cl 

/Subtract  number  of  lines  to  be  scrolled 

sub 

bh,dh 

/Calculate  number  of  columns 

Inc 

dh 

call 

calo 

/Convert  upper  left  in  offset 

mov 

si,di 

/Record  address  in  SI 

add 

bl,cl 

/First  line  in  scrolled  window 

call 

calo 

/Convert  first  line  in  offset 

xchg 

si,dl 

/Exchange  SI  and  DI 

CII^ 

wait,0 

/Flicker  suppressed? 

je 

supjO 

/NO  -->  SUPO 

wait ret 

/YES  — >Wait  for  retrace 

setmode  00100101b 

/Disable  screen 

supO: 

push  ds 

/Store  segment  register 

push 

es 

/On  the  stack 

mov 

ax,VIO_SEG 

/Segment  address  of  the  video  RAM 

mov 

ds,ax 

/To  DS 

mov 

es,ax 

/And  ES 

supl: 

mov 

ax,di 

/Record  DI  in  AX 

mov 

bx,si 

/Record  SI  in  BX 

mov 

cl,dh 

/Number  of  columns  in  counter 

rep  movsw 

/Move  a  line 

mov 

di,ax 

/Restore  DI  from  AX 

mov 

si,bx 

/Restore  SI  frcxn  BX 

add 

dl,160 

/Set  next  line 

add 

si, 160 

dec 

dl 

/processed  all  lines  ? 

jne 

supl 

/NO  — >  move  another  line 

pop 

es 

/Get  segment  register  frcxn 

pop 

ds 

/Stack 

cmp 

wait,0 

/Flickering  suppressed? 

je 

sup2 

/NO  — >  SUP 2 

setmode  00101101b 

/YES  — >  Enable  screen 

sup2: 

pop 

dx 

/Get  lower  right  comer  back 

pop 

cx 

/Return  number  of  lines 

pop 

bx 

/Return  upper  left  comer 

mov 

bl,dl 

/Lower  line  to  BL 

sub 

bl,cl 

/Subtract  number  of  lines 

inc 

bl 
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mov 

ah, 07h 

; Color  :  black  on  white 

call 

clear 

; Clear  lines 

pop 

si 

;CX  and  DX  have  already  been 

pop 

di 

; Restored 

pop 

bx 

pop 

ax 

ret 

;Back  to  caller 

scrollup  endp 


—  SCROLLDN:  scrolls  a  window  N  lines  down  - 

—  Input  :  BL  «  line  upper  left 

BH  «  colunm  upper  left 
DL  «  line  below  right 
DH  *  column  below  right 
CL  =  number  of  lines  to  be  scrolled 
:  BP  =  number  of  the  screen  page  (0  to  3) 

—  Output  :  none 

—  register  :  only  FLAGS  are  changed 

—  Info  :  the  display  lines  liberated  are  cleared 


scrolldn 


sdnO: 


sdnl; 


proc 

near 

cld 

;On  string  commands  count  up 

push 

ax 

; Record  all  changed  registers 

push 

bx 

;On  the  stack 

push 

di 

;In  this  case  the  sequence 

push 

si 

;Must  be  observed  ! 

push 

bx 

/These  three  registers  are  returned 

push 

cx 

/From  the  stack  before  the  end 

push 

dx 

/Of  the  routine 

sub 

dh,bh 

/Calculate  the  number  of  columns 

inc 

dh 

mov 

al,bl 

/Record  line  upper  left  in  AL 

mov 

bl,dl 

/Line  below  right  to  line  below  left 

call 

calo 

/Convert  upper  left  in  offset 

mov 

si,di 

/Record  address  in  SI 

sub 

bl,cl 

/Subtract  number  of  characters  to  scroll 

call 

calo 

/Convert  upper  left  in  offset 

xchg 

si,di 

/Exchange  SI  and  DI 

sub 

dl,al 

/Calculate  number  of  lines 

inc 

dl 

sub 

dl,cl 

/Subtract  number  of  lines  to  be  scrolled 

cup 

wait,0 

/Flicker  suppressed? 

Je 

sdnO 

/NO  — >  SDNO 

wait ret 

/YES  — >  Wait  for  retrace 

setmode  00100101b 

/Disable  screen 

push  ds 

/Store  segment  register  on  the 

push 

es 

/Stack 

mov 

ax,VIO_SEG 

/Segment  address  of  the  video  RAM 

mov 

ds,ax 

/To  DS 

mov 

es,ax 

/and  ES 

mov 

ax,di 

/Record  DI  in  AX 

mov 

bx,si 

/Record  SI  in  BX 

mov 

cl,dh 

/Number  of  columns  in  counter 

rep  movsw 

/Move  a  line 

mov 

di,ax 

/Restore  DI  from  AX 

mov 

si,bx 

/Restore  SI  from  BX 

sub 

di,160 

/Set  into  next  line 

sub 

si, 160 

dec 

dl 

/processed  all  lines  ? 
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jne 

sdnl 

;NO  — >  move  another  line 

pop 

es 

/Return  segment  register  from 

pop 

ds 

/Stack 

anp 

walt,0 

/Flicker  su^^ressed? 

je 

sdn2 

/NO  — >  SDN2 

setmode  00101101b 

/YES  — >  Enable  screen 

sdn2:  pop 

dx 

/Get  lower  right  corner 

pop 

cx 

/Return  number  of  lines 

pop 

bx 

/Return  upper  left  corner 

mov 

dl,bl 

/upper  line  to  DL 

add 

dl,cl 

/Add  number  of  lines 

dec 

dl 

mov 

ah, 07h 

/Color  :  black  on  white 

call 

clear 

/Erase  liberated  lines 

pop 

si 

/CX  and  DX  have  already  been 

pop 

di 

/ Returned 

pop 

bx 

pop 

ax 

ret 

/Back  to  caller 

scrolldn  endp 

/ —  CLS:  Clear 

the  screen  con^letely  - 

/ —  Input  :  BP  »  number 

of  the  screen  page  (0  or  1) 

/ —  Output  :  none 

/ —  register  : 

only  FLAGS 

are  changed 

els  proc 

near 

mov 

ah,07h 

/Color  is  white  on  black 

xor 

bx,bx 

/upper  left  is  (0/0) 

mov 

dx, 4F18h 

/Lower  right  is  (79/24) 

; —  Execute  Clear 


els  endp 


—  CLEAR:  fills  a  designated  display  area  with  space  characters 

—  Input  :  AH  =  attribute/color 


— 

BL  -  line 

upper  left 

— 

BH  =  column  upper  left 

— 

DL  *  line  below  right 

— 

DH  =  column  below  right 

— 

BP  =  number  of  the  screen  page  (0  to  3) 

—  Output  : 

none 

—  register  : 

only  FLAGS 

are  changed 

clear  proc 

near 

cld 

/On  string  commands  count  up 

push 

cx 

/Store  all  register  which  are 

push 

dx 

/Changed  on  the  stack 

push 

si 

push 

di 

push 

es 

sub 

dl,bl 

/Calculate  number  of  lines 

inc 

dl 

sub 

dh,bh 

/Calculate  number  of  columns 

inc 

dh 

call 

calo 

/Offset  address  of  the  upper  left 

mov 

cx,VIO_SEG 

/Segment  address  of  the  video  RAM 

mov 

es,cx 

/To  ES 

xor 

ch,ch 

/Hi  bytes  of  the  counter  to  0 
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nvov  al,"  “  ; Space  character 

crap  walt,0  /Flickering  suppressed? 

je  clear  1  ;N0  -->  CLEARl 


clearl : 


clear?: 


clear 


push  dx 

/Store  DX  on  the  stack 

waitret 

/Retrace  wait 

setmode  00100101b 

/Switch  screen  off 

pop 

dx 

/Return  DX  from  the  stack 

mov 

sl,dl 

/Record  DI  in  SI 

mov 

cl,dh 

/Number  columns  in  counter 

rep  1 

stosw 

/Store  space  character 

mov 

di,si 

/Return  DI  from  SI 

add 

di,160 

/Set  in  next  line 

dec 

dl 

/All  lines  processed  ? 

jne 

clearl 

/NO  — >  erase  another  line 

crap 

wait,0 

/Flicker  suppressed? 

je 

clear? 

/NO  -->  CLEAR? 

setmode  00101101b 

/Enable  screen 

pop 

es 

/Get  registers  from 

pop 

di 

/Stack  again 

pop 

si 

pop 

dx 

pop 

cx 

ret 

/Back  to  caller 

endp 

—  PRINT:  outputs  a  string  on  the  screen 

—  Input  :  AH  “  attribute/color 


; — 

DI  -  offset  address  of  the  first  character 

; — 

SI  »  offset  address  of  the  strings  to  DS 

; — 

BP  «  number  of  the 

screen  page  (0  to  3} 

/ —  Output  : 

DI  points  behind  the  last  character  output 

/ —  register  : 

AL,  DI  and  FLAGS  are  changed 

/ —  Info 

: 

the  string  must  be 

terminated  by  a  NUL-character. 

; — 

other  control  characters  are  not  recognized 

print 

proc 

near 

cld 

/On  string  ccmitiands  count  up 

push 

si 

/Store  SI,  DX  and  ES  on  the  stack 

push 

es 

push 

cx 

push 

dx 

mov 

dx,VIO_SEG 

/Segment  address  of  the  video  RAM 

mov 

cl, wait 

/Get  WAIT  flag 

mov 

es,dx 

/First  to  DX  and  then  to  ES 

jmp 

short  prints 

/Get  character  and  display  it 

printl 

label  near 

or 

cl,  cl 

/Flicker  suppressed? 

je 

print? 

/NO  — >  PRINT? 

push 

ax 

/Record  characters  and  color 

mov 

dx,3DAh 

/Address  of  the  display-status-register 

hrl: 

in 

al,dx 

/Get  content 

test 

al,l 

/Horizontal  retrace? 

jne 

hrl 

/NO  — >  wait 

cli 

/permit  no  further  interrupts 

hr?: 

in 

al,dx 

/Get  content 

test 

al,l 

/Horizontal  retrace? 

je 

hr? 

/YES  ~>  wait 

pop 

ax 

/Restore  characters  and  color 
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sti 

print 2: 

stosw 

print 3 : 

lodsb 

or 

al,al 

jne 

print 1 

printer 

pop 

dx 

pop 

CX 

pop 

es 

pop 

si 

ret 

print 

endp 

;Do  not  suppress  Interr\:qpts  any  more 

; Store  attribute  and  color  in  V-RAM 
;Get  next  character  from  the  string 
;Is  it  NUL 
;N0  — >  output 

;Get  SI,  DX,  CX  and  ES  from  stack 


/Back  to  caller 


—  CALO:  Converts  line  and  column  into  offset  address 

—  Input  :  BL  *  line 

BH  “  column 

BP  »  number  of  the  screen  page  (0  to  3) 

—  Output  :  DI  =  the  offset  address 

—  register  ;  DI  and  FLAGS  are  changed 


calo  proc  near 

push  ax 
push  bx 


shl 

mov 

xor 

mov 

xor 

add 

mov 

mov 

ror 

add 

pop 

pop 

ret 

calo  endp 


bx,  1 

al,bh 

bh,bh 

di, [lines+bx] 

ah,  ah 

di,ax 

bx,bp 

cl,  4 

bx,cl 

di,bx 

bx 

ax 


/Secure  AX  on  the  stack 
/Secure  BX  on  the  stack 

/Column  and  line  times  2 
/Column  to  AL 
/Hi  byte 

/Get  offset  address  of  the  line 
/HI  byte  for  column  offset 
/Add  line  and  column  offset 
/Screen  page  to  BX 
/Multiply  by  4,096 

/Add  beginning  of  screen  page  to  offset 
/Restore  BX  from  stack 
/Restore  AX  from  stack 
/Back  to  caller 


—  CGR:  Erase  the  complete  Graphic  display  - 

—  Input  :  AL  =  OOH  :  erase  all  pixels 

FFH  :  set  all  pixels 
' —  Output  :  none 

—  register  :  AH,  BX,  CX,  DI  and  FLAGS  are  changed 

: —  Info  :  this  Function  erases  the  Graphic  display  in  both 

^ —  Graphic  modes 


proc 

near 

push 

cbw 

es 

xor 

di,di 

mov 

bx,VIO_SEG 

mov 

es,bx 

mov 

CX, 2000h 

rep  stosw 

pop 

es 

ret 

endp 

/Store  ES  on  the  stack 

/Expand  AL  to  AH 

/Offset  address  in  video  RAM 

/Segment  address  screen  page 

/Segment  address  into  segment  register 

/One  page  is  8KB  words 

/Fill  page 

/Return  ES  from  stack 
/Back  to  caller 


—  PIXLO:  sets  a  pixel  in  the  320*200  pixel  graphic  mode 

—  Input  ;  BP  »  number  of  the  screen  page  (0  or  1) 

-  BX  *  column  (0  to  319) 

DX  «  line  (0  to  199) 

AL  =  color  of  the  pixels  (0  to  3) 
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Output 

register 


none 

AX,  DI  and  FLAGS  are  changed 


plxlo 


proc  near 


push 

ax 

/Secure  AX  on  the  stack 

push 

bx 

/Note  BX  on  the  stack 

push 

cx 

/Store  CX  on  the  stack 

mov 

cl,  7 

mov 

ah,bl 

/Transmit  column  to  AH 

and 

ah, 11b 

/Column  mod  4 

shl 

ah,l 

/Column  *  2 

sub 

cl,  ah 

/7  -  2  ♦  (column  mod  4) 

mov 

ah,  11 

/Bit  value 

shl 

ax,  cl 

/Move  to  pixel  position 

not 

ah 

/Reverse  AH 

shr 

bx,  1 

/Divide  BX  ty  4  by  shifting 

shr 

bx,l 

/Right  twice 

jmp 

short  spix 

/Set  pixel 

pixlo 

endp 

PIXHI 

:  sets  a  pixel  in  the  640^200  pixel  graphic  mode  - 

; —  Input 

: 

BP  *  number  of  the  screen  page  (0  or  1) 

; — 

BX  “  column 

(0  to  639) 

; — 

DX  *  line 

(0  to  199) 

; — 

AL  =  color  of  the  pixels  (0  or  1) 

; —  Output  : 

none 

; —  register  : 

AX,  DI  and 

FLAGS  are  changed 

pixhi 

proc 

near 

push 

ax 

/Store  AX  on  the  stack 

push 

bx 

/Note  BX  on  the  stack 

push 

cx 

/Note  CX  on  the  stack 

mov 

cl,  7 

mov 

ah,bl 

/Transmit  column  to  AH 

and 

ah, 111b 

/Column  mod  8 

sub 

cl,  ah 

/7  -  column  mod  8 

mov 

ah,l 

/Bit  value 

shl 

ax,  cl 

/Move  pixel  position 

not 

ah 

/Reverse  AH 

mov 

cl,  3 

/3  shifts 

shr 

bx,  cl 

/Divide  BX  by  8 

pixhi 

endp 

SPIX; 

sets 

a  pixel  in  the  graphic  display  - 

; —  Input 

: 

BX  =  column  offset 

; — 

DX  «  line 

(0  to  199) 

; — 

AH  «  Value 

to  cancel  old  Bits 

; — 

AL  «  new  Bit  value 

; —  Output  : 

none 

; —  register  : 

AX,  DI  and 

FLAGS  are  changed 

spix 

proc 

near 

push 

es 

/Secure  ES  on  the  stack 

push 

dx 

/Secure  DX  on  the  stack 

push 

ax 

/Secure  AX  on  the  stack 

xor 

di,dl 

/Offset  address  in  video  RAM 

mov 

cx,VIO  SEG 

/Segment  address  screen  page 

mov 

es,  cx 

/Segment  address  into  segment  register 

mov 

ax,dx 

/Move  line  to  AX 

shr 

ax,l 

/Divide  line  by  2 

mov 

cl,  80 

/The  factor  is  90 

mul 

cl 

/Multiply  line  ky  80 
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splx 

end 

code 


and 

dx,  1 

;Llne  mod  2 

mov 

cl,  3 

;3  shifts 

ror 

dx,  cl 

/Rotate  right  (*  2000H) 

mov 

dl,ax 

;80  *  int (line/2) 

add 

dl,dx 

;+  2000H  *  (line  mod  4) 

add 

dl,bx 

;Add  column  offset 

pop 

ax 

/Return  AX  from  stack 

mov 

bl,es: [dl] 

/Get  pixel 

and 

bl,ah 

/Erase  Bits 

or 

bl,al 

/Add  pixel 

mov 

es: [di],bl 

/write  pixel  back 

pop 

dx 

/Return  DX  from  stack 

pop 

es 

/Return  ES  from  stack 

pop 

cx 

/Return  CX  from  stack 

pop 

bx 

/Return  BX  from  stack 

pop 

ax 

/Return  AX  from  stack 

ret 

/Back  to  caller 

endp 


ends  ;End  of  the  code  segment 

end  demo 
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10.5  EGA  and  VGA  Cards 

The  EGA  and  VGA  cards  far  exceed  their  predecessors  in  both  gn^hics  and  in  text 
display  capabilities.  Other  computers  have  had  EGA  and  VGA  capabilities  for 
some  time  (e.g.,  work  stations,  CAD/CAM  applications),  but  these  video  cards  are 
now  at  prices  wh^  many  home  systems  will  soon  have  them. 

The  range  of  power  of  this  new  generation  of  video  cards  can  be  seen  in  their  very 
sharp  resolutions  and  their  ability  to  display  almost  any  number  of  lines  on  the 
screen.  The  EGA  and  VGA  cards*  greatest  feature  lies  in  their  ability  to  emulate 
other  video  cards. 

These  capabilities  come  with  a  price — more  complicated  hardware  and 
programming  are  required.  One  result  of  this  is  that  the  features  of  an  EGA  card  or 
a  VGA  card  can  no  longer  be  realized  with  the  traditional  PC  video  controller  (the 
Motorola  6845).  Instead,  most  EGA  and  VGA  cards  contain  a  VLSI  chip  developed 
especially  for  use  on  an  EGA  card.  At  the  heart  of  this  component  is  a  video 
controller  that  controls  the  video  signal  generation.  Its  basic  task  is  similar  to  that 
of  the  6845,  but  its  registers  differ  from  those  of  the  6845,  both  in  number  and 
interaction  between  registers.  Comparing  the  6845  and  VSLI  is  like  comparing 
BASIC  and  assembly  language,  where  the  increase  of  power  is  in  proportion  to  the 
degree  of  language  complexity. 

We  recommend  that  you  avoid  programming  the  hardware  registers  directly  unless 
you  absolutely  must  do  so.  Many  tasks  can  be  delegated  to  the  BIOS  without 
wasting  much  time.  Not  only  will  this  keep  your  program  code  more  compact  and 
easier  to  read,  it  will  greatly  improve  the  compatibility  of  your  code  with  other 
video  cards.  Among  the  tasks  which  the  various  functions  of  the  BIOS  video 
interrupt  can  perform  are: 

•  Initialization  of  the  video  mode 

•  Selection  of  the  display  page 

•  Cursor  positioning 

•  Defining  the  starting  and  ending  line  of  the  cursor 

•  Palette  and  border  color  selection 

•  Setting  the  size  of  the  character  matrix,  and  thereby  the  number  of  text 
lines  which  can  be  displayed  on  the  screen 

•  Loading  usCT-defined  character  sets 

•  Reading  configuration  data 

Detailed  information  about  traditional  BIOS  video  functions  and  the  new  functions 
of  the  EGAA^GA  BIOS  can  be  found  in  Sections  7.4. 
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If  you  need  speed  and  maximum  control  over  the  screen,  you  should  sdll  pnftrnn 
time-critical  actions  (e.g.,  manipulating  video  RAM)  "by  hand." 

EGAA'^GA  and  text  mode 

There  is  no  difference  between  the  EGA  and  MDA  or  CXjA  card  in  text  mode.  The 
video  RAM  and  attribute  byte  are  organized  the  same  way  for  the  EGA  card  as  for 
the  otho*  two  cards — even  the  location  of  the  video  RAM  is  the  same.  But  since  an 
EGA  card  can  emulate  either  a  CGA  card  or  an  MDA  card,  depending  on  the 
monitor  to  which  it  is  connected,  you  should  first  determine  what  kind  monitor  is 
in  use.  From  this  the  EGA  can  detmnine  which  of  the  two  systems  to  mulate 
(routines  presented  in  Section  10.7  show  how  this  is  done).  The  type  of  card  being 
emulated  detomines  where  the  video  RAM  can  be  found  in  memory,  how  the  bits 
of  the  character  attribute  byte  are  interpreted,  and  how  many  screen  pages  are 
available. 

Remember  that  the  EGA  oi  VGA  card  does  not  contain  a  6845  CRTC,  despite  the 
fact  that  it  can  pofectly  emulate  its  video  predecessors.  This  means  that  the  status 
and  control  registers  of  the  MDA  and  CGA  cards  are  unavailable.  However,  since 
the  settings  that  are  normally  made  with  these  registers  can  also  be  performed  with 
the  BIOS,  we  don’t  really  need  these  registers.  You  should  also  remember  that 
there  are  no  restrictions  to  accessing  the  video  RAM  of  an  EGA  card  or  a  VGA 
card  when  it  is  in  CGA  emulation.  It  is  utmecessary  to  synchronize  screen  access 
with  the  activity  of  the  CRTC  by  reading  the  status  regist^. 

The  parallels  between  the  organization  of  the  video  RAM  in  the  CGA  and  MDA 
cards  also  apply  when  the  text  mode  is  switched  to  43  lines  (which  is  impossible 
in  CGA  emulation).  As  with  any  other  number  of  displayed  lines,  this  does  not 
change  the  basic  structure  of  the  video  RAM  at  all.  It  is  larger,  but  the  formulas 
for  calculating  the  offset  position  of  a  character  and  its  attribute  byte  within  the 
video  RAM  are  still  valid. 

The  VGA  card  is  capable  of  25, 43  and  even  50  lines  in  text  mode,  depoiding  on 
the  monitcH’  in  use. 

These  parallels  also  aiq;>ly  to  the  gnq)hics  modes  already  availaUe  to  the  CGA  card. 
The  position  of  the  video  RAM  and  its  structure  are  identical  to  the  those  of  the 
CGA  card. 

EGA/VGA  and  graphic  modes 

The  EGA  card  ofCos  the  following  new  graphics  modes: 

•  320x200  pixels,  16  colors  (BIOS  code:  ODH) 

•  640x200  pixels,  16  colors  (BIOS  code:  OEH) 

•  640x350  pixels,  2  colors  (BIOS  code:  OFH) 
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•  640x350  pixels,  16  colors  (BIOS  code:  lOH) 

The  VGA  card  offos  the  following  gngthic  modes: 

•  640x480  pixels,  2  col(»s  (BIOS  code:  1 IH) 

•  640x480  pixds,  16  colors  (BIOS  code:  12H) 

•  320x200  pixels,  256  coitus  (BIOS  code:  13H) 

Some  EGA  cards  have  even  more  modes  with  higher  resolution  or  mme  colors, 
but  these  modes  are  not  part  of  the  EGA  standard  and  are  supported  by  only  a  few 
I»x>grams. 

It  is  somewhat  difficult  to  talk  about  a  "standard",  because  almost  every 
manufacturer  has  their  own  modes.  Let's  look  at  the  lowest  common 
denominator — the  modes  which  practically  all  EGA/VGA  cards  support.  These  are 
the  modes  siq)ported  by  the  original  EGA  card,  the  IBM  EGA. 

These  video  modes,  in  which  the  video  RAM  can  occupy  more  than  lOOK,  show  a 
sttiicture  quite  diffaent  from  those  used  by  the  MDA,  CGA  and  H»cules  cards. 
The  maximum  of  256K  of  RAM  is  divided  into  four  bitplanes  which  are  arranged 
in  a  kind  of  a  three-dimensional  organization.  From  the  processor's  point  of  view 
these  bitplanes  reside  between  segment  addresses  A(XX)H  and  B(XX)H. 

Each  bitplane  contains  one  bit  for  each  individual  pixel.  If  you  place  the  bitplanes 
on  top  of  each  other,  each  pixel  is  represented  by  a  to^  of  four  bits,  which 
together  make  up  the  color  value  of  the  pixel.  Bitplane  zero  contains  bit  zero  of 
the  color  value  of  each  pixel,  bitplane  one  contains  bit  one,  and  so  on.  This  limits 
the  number  of  displayable  colors  to  16,  since  four  bits  (or  bitplanes)  can  represent 
2^,  at  16  diffnent  numbers. 

The  color  value  obtained  from  combining  individual  bitplanes  does  not  correspond 
directly  to  a  color.  It  is  actually  used  as  an  index  into  one  of  the  16  p^ette 
registers  of  the  EGA  card,  each  of  which  designates  a  particular  color.  Since  the 
EGA  card  can  display  a  total  of  64  different  colors,  the  palette  registers  allow  you 
to  select  16  of  these  colors  to  be  displayed  on  the  screen  simultaneously.  The 
individual  palette  registos  can  be  load^  with  the  help  of  the  extended  EGA  BIOS 
functions,  as  described  in  Section  7.4. 

The  structure  of  each  bitplane  corresponds  to  the  organization  of  the  pixels  on  the 
screen,  and  parallels  that  of  video  RAM  in  text  mode.  Since  each  pixel  occupies 
one  bit  in  the  bitplane,  eight  consecutive  pixels  are  combined  into  a  byte.  The 
pixels  on  each  line  are  placed  left  to  right  in  successive  memory  locations.  The 
length  of  each  line  can  be  detmnined  using  the  formula: 

horizontal_resolution  /  8 
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Since  the  individual  screen  lines  follow  each  other  in  sequence  starting  from  the 
top  of  the  screen,  the  starting  address  of  each  line  is  obtained  by  multiplying  the 
line  number  by  this  value.  Hie  byte  within  this  line  which  contains  the  desired 
pixel  is  calculated  by  dividing  the  column  numba  by  eight  (bits  pex  byte).  Adding 
this  to  the  starting  address  of  the  line  gives  us  the  following  fwmula,  which 
calculates  the  offret  address  of  the  byte  containing  the  cotHdinates  (X,  Y): 

Y  *  (horizontal_resolution  /  8)  +  X  /  8 


X  columns 

^  -■■■■■■ 


The  bit  number  at  which  the  pixel  is  located  in  this  byte  results  from  the 
remainder  of  the  division  of  the  colunm  numba  by  eight: 

7  -  (column_number  MOD  8) 

These  two  formulas  can  be  used  to  localize  a  pixel  within  a  bitplane  and 
implement  graphics  primitives. 

However,  the  bitplanes  carmot  be  accessed  individually  because  they  all  lie  at  the 
identical  segment  address.  The  EGA  card  has  four  latch  registers,  each  of  which 
contains  a  complete  byte  from  one  of  the  four  bitplanes.  When  the  CPU  performs 
a  read  access  ^m  the  EGA  video  RAM  at  segment  address  AOOOH,  one  byte  is 
first  read  from  each  of  the  four  bitplanes  at  the  specified  offset  address  and  loaded 
into  the  four  latch  registers.  This  applies  to  instructions  which  access  memory 
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directly,  such  as  MOV  ot  LODS,  as  well  as  all  instructions  in  which  a  byte  from 
the  video  RAM  aiq)ears  as  an  operand.  This  can  be  the  case  with  arithmetic 
instructions  (ADD,  SUB,  OR,  AND,  etc.)  and  comparison  instructions  (CMP, 
CMPS). 

The  process  is  similar  for  writing  bytes  to  the  video  RAM.  In  this  situation  the 
contents  of  the  four  latch  regist^  are  written  back  to  the  four  bitplanes. 


bits  01234567 


bits  01234567 


Video  RAM  access— writing  the  four  latch  registers 

Since  the  latch  registers  are  not  directly  accessible  to  the  processor,  we  must 
alternate  conversion  between  eight  and  32  bits  when  reading  and  writing  the  video 
RAM.  When  reading,  32  bits  from  the  latch  registers  must  be  compressed  into  one 
byte,  while  the  eight  bits  from  the  CPU  when  writing  must  be  divided  among  the 
32  bits  of  the  latch  registos.  The  nine  gr£q)hic  controller  registo^  in  the  EGA  card 
perf(»m  this  conversion. 
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|ega  graphic  controller  registers  and  their  default  values  | 

Register 

Meaning 

Default 

OOH 

Set  /  Reset 

OOH 

OlH 

Enable  Set  /  Reset 

OOH 

02H 

Color  Compare 

OOH 

03H 

Function  Select 

OOH 

04H 

Read  Map  Select 

OOH 

OSH 

Mode 

OOH 

06H 

Miscellaneous 

varies 

07H 

Color  Don’t  Care 

OFH 

08H 

Bit  Mask 

FFH 

Access  to  these  registers  is  similar  to  CRTC  register  access  on  the  Hercules 
graphics  card.  Here  too  there  is  an  address  register  at  port  address  3DEH,  into 
which  we  must  first  load  the  number  of  the  register  in  the  graphics  controller  that 
we  want  to  access.  The  value  for  this  register  can  then  be  written  to  the  data 
register  located  at  address  3CFH,  immediately  after  the  address  register.  These  ports 
do  not  have  to  be  accessed  separately:  A  16-bit  OUT  instruction  to  the  address 
register  performs  the  access  in  one  move.  The  AX  register,  which  will  be  sent  to 
this  port,  must  contain  the  register  number  in  the  low-order  byte  (AL),  and  the 
value  fcx  this  register  in  the  high-order  byte  (AH).  Although  values  can  be  loaded 
into  the  graphics  controller  registers  in  this  manner,  it  is  not  possible  to  read  data 
from  the  EGA  card. 

The  contents  of  register  number  five,  the  mode  register,  are  responsible  for  the 
behavior  of  the  video  RAM.  This  register  controls  the  current  read  and  write 
modes  and  thereby  the  manner  in  which  the  data  from  the  latch  registers  is 
combined  with  the  other  registers  in  the  graphics  controller  and  the  CPU  data. 


7  6  5  4  3  2  1  0  bit 


Mode  register  structure  in  EGA  card  graphics  controller 
There  are  a  total  of  two  different  read  modes  and  three  write  modes. 


524 


Abacus 


105  EGA  and  VGA  Cards 


Read  mode  0 


Read  mode  0  is  the  simple’  of  the  two  read  modes.  As  usual,  a  read  access  in  this 
mode  first  loads  the  specified  byte  from  the  four  bitplanes  into  the  four  latch 
registers.  Then  the  contents  of  the  latch  register  q)ecifi^  by  the  lower  two  bits  of 
the  read  map  select  register  (register  four)  are  transferred  to  the  CPU. 


bits 


Read  Map 
Select  Register 

Video  RAM  read  access  in  read  mode  0 


The  following  sequence  of  assembly  language  instructions  first  sets  read  mode  0, 
then  writes  the  value  2  into  the  Read  Mdip  Select  register,  and  finally  reads  a  byte 
from  offset  address  0003H  in  the  video  RAM.  As  a  result,  the  AL  register  contains 
the  bit  values  for  the  pixels  with  coordinates  (24, 0)  to  (31, 0)  from  bitplane  2. 


mov  dx,3CEh 
mov  ax,0005h 
out  dx,ax 
mov  ax,0204h 
out  dx,ax 
mov  ax,0A000h 
mov  ds,ax 
mov  si,0003h 
lodsb 


;port  address  of  the  graphics  cont.  addr.  reg. 
; write  read  mode  0  in  the  mode  register 

; write  the  value  2  (plane  number)  in  the 
;read  map  select  register 
/segment  address  of  the  video  RAM 
;to  DS 

/offset  address  into  the  video  RAM 
/read  byte  from  plane  2 


Read  mode  l 


Read  mode  1  specifies  which  of  the  eight  pixels  in  the  specified  byte  of  video 
RAM  is  set  to  a  certain  color.  This  is  determined  by  the  individual  bits  in  the  read 
byte  which  correspond  to  the  one  of  the  eight  pixels  from  the  specified  byte  in  the 
video  RAM.  If  a  pixel  has  the  specified  color  (appropriate  bit  map),  then  the 
corresponding  bit  will  be  1,  else  0.  The  bit  pattern  of  the  color  to  be  compared 
must  be  loaded  into  the  lower  four  bits  of  the  Color  Compare  register.  The  lower 
four  bits  of  the  Color  Don't  Care  register  show  which  bitplanes  will  be  taken  into 
consideration  in  the  comparison.  The  value  1  includes  the  given  plane  in  the 
comparison,  while  the  value  0  excludes  it. 
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Video  RAM  read  access  in  read  mode  1 


The  following  program  sequence  determines  which  of  the  pixels  between 
coordinates  (0, 0)  and  (7, 0)  have  color  value  five.  First,  read  mode  1  is  set  by  the 
Mode  register.  Then  the  color  value  to  be  tested  (five)  is  loaded  into  the  Color 
Compare  register.  We  must  also  load  the  Color  Don’t  Care  register  with  the  value 
1 1 1  lb  so  that  all  four  bitplanes  will  be  included  in  the  comparison.  However,  this 
is  the  default  value  and  we  have  not  loaded  any  other  value  into  this  regista*,  so  we 
can  skip  this  step.  After  programming  the  registers  of  the  graphics  controller,  we 
load  the  segment  and  offset  addresses  of  the  pixels  to  be  compared  into  the  DS  and 
SI  registers.  Then  the  read  is  executed  from  the  video  RAM. 


526 


Abacus 


103  EGA  andVGA  Cards 


mov  dx,3CEh 
mov  ax,0805h 
out  dx,ax 
mov  ax, 0502h 
out  dx,ax 
mov  ax,0A000h 
mov  ds,ax 
xor  si, si 
lodsb 


;port  address  of  the  graphics  cont.  addr.  reg. 
; write  read  mode  1  Into  the  mode  register 

; write  color  value  15  into  the 
/Color  Conpare  register 
/segment  address  of  the  video  RAM 
/to  DS 

/load  offset  address  0 
/read  and  conpare  pixels, 

/return  result  In  AL 


Write  mode  0 


Writing  to  the  video  RAM  in  write  mode  0  results  in  a  number  of  opo'ations,  all 
of  which  depend  on  the  contents  of  sevoal  registers.  The  contents  of  the  Bit  Mask 
register  determine  whether  the  value  of  a  bit  in  the  four  latch  registers  will  be 
written  unchanged  to  the  found  bitplanes  or  whether  it  will  first  be  modified.  The 
individual  bits  in  the  Bit  Mask  register  correspond  to  the  individual  bits  in  the  four 
latch  regist^.  If  a  bit  in  the  Bit  Mask  register  is  0,  the  corresponding  bits  in  the 
latch  registers  will  be  written  to  the  bitplanes  unchanged.  If  this  bit  is  1,  a 
modification  will  take  place,  dqtendent  on  the  contents  of  the  Function  Select 
registo'.  As  the  following  figure  shows,  the  bits  can  be  replaced  or  modified  with 
the  logical  operations  AND,  OR,  and  XOR. 

7  654  321  Obit 


Comparison  modes 
00b  =  Replace 
01b  =  AND  comparison 
10b  s  OR  comparison 
11b  =  XOR  comparison 


Function  Select  Register  structure  in  EGA  card  graphics  controller 

The  contents  of  the  Enable  Set/Reset  register  detomines  from  where  the  other 
operand  in  these  operations  will  come.  If  the  lower  four  bits  contain  the  value  1, 
the  other  operand  will  come  from  the  lower  four  bits  of  the  Set/Reset  register. 
Each  of  these  bits  is  then  combined  with  the  bits  from  the  latch  registers  as 
described  by  the  contents  of  the  Function  Select  register.  All  of  the  bits  to  be 
modified  from  latch  register  0  will  then  be  opraated  on  with  bit  0  of  the  Set/Reset 
register.  In  the  same  manna,  all  of  the  bits  to  be  modified  fiom  latch  registers  1, 
2,  and  3  are  combined  with  bits  1, 2,  and  3  of  the  Set/Reset  register,  respectively. 
The  byte  which  is  actually  written  to  the  graphics  controller  becomes  irrelevant  at 
this  point — the  write  access  is  reduced  to  a  trigger,  which  cannot  have  any  direct 
influence  on  the  contents  of  the  latch  register  (and  therefore  the  biQilanes). 
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Latch  #0  Latch  #1  Latch  #2  Latch  #3 
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Byte  in:  Bitplane  #0  Bitplane  #1  Bitplane  #2  Bitplane  #3 


Write  access  to  video  RAM  (write  mode  0)  when  Enable  Set! Reset  register 
contains  a  value  of  (XXMlIllib) 

The  following  assembly  language  fragment  assigns  the  pixels  at  coordinates  (5, 0) 
and  (7, 0),  found  at  offset  address  OOOOH  in  the  video  RAM,  the  color  101 1(b). 


Since  we  don't  want  to  change  the  color  of  the  other  pixels,  the  contents  of  the 
byte  are  first  read  into  the  latch  register  with  a  read  access  to  the  video  RAM.  It  is 
not  important  which  read  mode  is  active  because  the  byte  transmitted  to  the  CPU 
is  irrelevant;  all  we  are  interested  in  is  loading  the  latch  register.  Since  only  bits  0 
(coordinates  (7, 0))  and  2  (coordinates  (5, 0))  will  be  changed,  we  load  the  value 
00000101b  (05h)  into  the  bitmask  register.  In  the  Function  Select  register  we 
write  the  value  0  because  we  want  to  replace  bits  0  and  2  with  a  new  bit 
combination.  We  write  the  color  we  want  to  give  to  the  two  bits  (101  lb  =  OBh)  in 
the  Set/Reset  register.  We  must  also  write  the  value  1111(b)  (OFH)  to  the  Enable 
Set/Reset  register  of  the  gr^hics  controller  so  that  the  color  value  will  be  taken 
from  the  Set/Reset  register.  We  can  then  execute  the  write  access  to  video  RAM. 


mov  ax, OAOOOh 
mov  ds,ax 
xor  bx,bx 
mov  al, [bx] 
mov  dx,3CEh 
mov  ax, OOOSh 
out  cix,ax 
mov  al,03h 
out  dx,ax 
mov  ax, 0508h 
out  dx,ax 
mov  ax,0B00h 
out  dx,ax 
mov  ax, OFOlh 
out  dx,ax 
mov  [bx],al 


; segment  address  of  the  video  RAM 
;to  DS 

;load  offset  address  0 

;load  byte  0  in  the  latch  register 

;port  address  of  the  graphic  cont.  addr.  reg. 

/read  mode  0,  write  more  0 

/write  in  the  mode  register 

/write  0  in  the  Function  Select  register 

/write  bit  mask  in  the  bitmask  register 

/write  new  color  value  in  the  Set /Reset  register 

/write  1111b  in  the  Enable  Set/Reset  register 

/trigger  latch  register 
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Things  aie  different  when  the  En^le  Set/Reset  registo*  contains  the  value  zero.  In 
this  case  all  of  the  bits  to  be  modified  from  the  four  latch  registers  are  combined 
with  the  C3*U  byte  latch  by  latch.  Here  again  the  type  of  operation  performed 
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depends  on  the  contents  of  the  Function  Select  legisto'.  Fw  example,  if  the  OR 
operation  is  selected  and  bits  1, 2, 4,  and  6  are  to  be  modified,  than  these  bits  of 
all  four  latch  registers  will  be  individually  ORed  with  bits  1,  2,  4,  and  6  in  the 
CPU  byte. 

Latch  #0  Latch  #1  Latch  #2  Latch  #3 


Byte  in:  Bitplane  #0  Bitplane  #1  Bitplane  #2  Bitplane  #3 


Write  mode  1 

Write  mode  1  is  quite  simple  compared  to  the  complex  opoations  of  write  mode  0. 
The  contents  of  the  registers  and  the  CPU  byte  are  irrelevant  because  the  contents 
of  the  four  latch  registers  are  loaded  unchanged  into  the  specified  offset  address 
within  the  four  biq)lanes.  This  is  useful  for  copying  the  color  values  of  eight 
successive  pixels  to  eight  other  pixels,  for  instance.  The  byte  containing  the  eight 
pixels  can  be  read  under  one  of  the  read  modes,  placing  it  in  the  latch  registers. 
Then  a  write  access  can  be  made  to  the  byte  in  video  RAM  to  which  you  want  to 
copy  the  color  values.  The  gr:q)hics  controUo'  will  automatically  copy  the  contents 
of  the  latch  registers  to  the  specified  position  within  the  four  biq>lanes. 

To  write  these  color  values  to  other  locations,  you  can  use  additional  write 
accesses.  No  more  read  accesses  are  necessary,  since  the  latch  registers  already 
contain  the  appropriate  values  and  their  contents  are  not  changed  by  the  write 
access. 

Write  mode  2 

Write  mode  2  resembles  a  combination  of  the  various  modes  of  write  mode  0.  As 
in  write  mode  0,  the  bitmask  register  determines  which  bits  will  be  taken  directly 
from  the  latch  registers  and  which  will  be  modified.  The  manno'  in  which  these 
bits  are  manipulated  is  again  determined  by  the  mode  selected  in  the  Function 
Select  register.  The  lower  four  bits  of  the  CPU  byte  will  be  combined  with  the 
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latch  registers,  indq)endent  of  the  Enable  Set/Reset  register.  Bit  jeto  of  the  CPU 
byte  is  combined  with  all  bits  in  latch  register  zero  which  are  to  be  modified.  The 
same  applies  fin*  CPU  bits  1, 2,  and  3,  which  are  combined  with  the  bits  of  latch 
registers  1, 2,  and  3,  respectively. 

Latch  #0  Latch  #1  Latch  #2  Latch  #3 


Imnm  imiM  »i  mmm  ii  »im  ii  >1 


Write  access  to  video  RAM  in  write  mode  2 


This  mode  is  good  for  setting  the  colors  of  individual  pixels,  as  we  demonstrated 
in  the  example  in  write  mode  0.  In  contrast  to  write  mode  0,  the  assembly- 
language  fragment  is  somewhat  shorter  because  neitho*  the  Enable  Set^eset  nor 
the  Set/Reset  register  has  to  be  programmed.  Here  is  the  same  example  using  write 
mode  2; 


mov  ax, OAOOOh 
mov  ds,ax 
xor  bx,bx 
mov  al, [bx] 
mov  dx,3CEh 
mov  ax, 0205h 
out  dx,ax 
mov  ax, 0003h 
out  dx,ax 
mov  ax,0508h 
out  dx,ax 
mov  al,0Bh 
mov  [bx],al 


; segment  address  of  the  video  RAM 
;in  DS 

;load  offset  address  0 

/load  byte  0  in  the  latch  registers 

/port  address  of  the  graphics  cont.  addr.  reg. 

/read  mode  0,  write  mode  2 

/write  into  the  mode  register 

/write  REPLACE  mode  (0)  in  the  Function 

/Select  register 

/write  the  bit  mask  to  the  bitmask  register 

/new  color  value  in  AL 

/and  frcxn  there  to  the  video  RAM  and 

/into  the  latch  regs  and  bitplanes 


Demonstration  program 

The  following  program  demonstrates  the  following  basic  graphics  routines: 

•  Calculating  the  position  of  a  pixel  within  the  video  RAM 

•  Setting  the  color  of  a  pixel 

•  Reading  the  color  of  a  pixel 

•  Filling  the  entire  video  RAM  with  a  color 
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If  you  have  followed  this  section  closely,  especially  the  material  on  the  read  and 
write  modes,  you  won't  have  any  problems  following  the  logic  of  the  various 
functions.  Since  it  contains  detailed  documentation,  we  won't  say  anything  more 
about  it 

It  should  be  noted  that  the  program  is  intended  for  demonstration  purposes  only. 
You  can  develop  it  further  if  you  want  to  make  a  graphics  library  out  of  these 
functions.  For  example,  the  function  PIXPTR  loads  the  segment  address  of  the 
video  RAM  into  the  ES  regist^  for  calculating  the  position  of  a  pixel  within  the 
video  RAM  each  time  it  is  called.  This  can  be  eliminated  by  loacUng  this  address 
into  the  register  once  at  the  beginning  of  the  program  and  leaving  it  there,  as  long 
as  the  other  functions  do  not  change  this  register. 

The  graphics  controller  register  programming  can  also  be  improved.  Here  the 
various  registers  are  reloaded  with  the  ROM-BIOS  default  values  after  the  function 
has  completed.  This  can  be  eliminated  as  long  as  you  do  not  use  the  BIOS 
functions  for  character  output  (in  the  graphics  mode)  or  the  functions  for  setting 
and  testing  points  within  the  module  or  program.  If  you  avoid  these  calls,  then 
these  registers  can  be  reset  to  their  default  values  once  at  the  end  of  the  program 
instead  of  at  the  end  of  each  routine. 

Assembler  listing:  VEGA.ASM 


.**********************************************************************. 


.  * 

.  * _ 

VEGA 

.  it 

.  ★ 

Task 

:  Creates  elementary  functions  for  accessing  the 
graphic  modes  on  an  EGA/ VGA  card 

.  ★ 

Author 

:  MICHAEL  TISCHER 

.  ★ 

Developed  on 

:  10/3/1988 

.  ★ 

.  ★ _ 

Last  update 

:  6/19/1989 

•  ★ 

.  ★ 

.  *  — 

Assembly 

:  MASM  VEGA; 

LINK  VEGA; 

t 

.  * 

Call 

:  VEGA 

. ★****★****★★***★******************************************************. 


;—  Constants - - - - - 

VIO_SEG  =  OAOOOh 

Segment  address  of  video  RAM 

in  graphic  mode 

LINE_LEN  »  80 

Every  graphi  line  in  EGA/ VGA  graphic 

modes  require  80  bytes 

BITMASK_REG  =  8 

Bitmask  register 

MODE  REG  =  5 

Mode  register 

FUNCSEL  REG  =  3 

Function  select  register 

MAPSEL  REG  =  4 

Map- Select  register 

ENABLE_REG  *  1 

Enable  Set /Reset  register 

SETRES  REG  =  0 

Set /Reset  register 

GRAPH  CONT  =  3CEh 

Port  addressd  of  graphic  controller 

OP_MODE  =  0 

Comparison  operator  mode: 

OOh  =  Replace 

08h  =  AND  comparison 

lOh  =  OR  comparison 

18h  «  EXCLUSIVE  OR  comparison 

GR_640_350  »  lOh 

rBIOS  code  for  64 0x3 50-pixel 
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; 16-color  graphic  mode 

TX_80_25  -  03h  ;BIOS  code  for  80*25-char. 

/text  mode 


stack  segment  para  stack  /Definition  of  stack  segment 

dw  256  dup  (?)  /256-word  stack 

stack  ends  /End  of  stack  segment 

/  ==  Data 

data  segment  para  'DATA'  /Definition  of  data  segment 

/=“  Data  for  the  demo  program 
initm  db  13,10 

db  "VEGA  (c)  1988  by  Michael  Tischer" 
db  13,10,13,10 

db  "This  demonstration  program  operates  only  with  an  EGA/", 13, 10 

db  "card  and  a  hi-res  monitor.  If  your  PC  doesn't  have  this", 13, 10 
db  "configuration,  please  press  the  <s>  key  to  abort  the", 13, 10 
db  "program. ",13,10 

db  "Press  any  other  key  to  start  the  program. ",13,10, "$" 
data  ends  /End  of  data  segment 

/  ==  Code  =====*======*======.«=*x====-=*===-»=«==-:=*«=«=====-=:=====*««.« 


code  segment  para  'CC»E'  /Definition  of  code  segment 

assume  cs:code,  dsrdata,  es:data,  ss:stack 
/==  Demo  program  =========«=»===*=*==*=======:==«:====«===.=*==® 


demo 

proc  far 

mov 

ax, data 

/Get  segment  addr.  from  data  segment 

mov 

ds,  ax 

/and  load  into  DS 

mov 

es,ax 

/and  ES 

Display  opening  message  and  wait  for  input  - 

mov 

ah,  9 

/Function  number  for  string  display 

mov 

dx, offset  initm 

/Message  address 

int 

21h 

/Call  DOS  Interrupt 

xor 

ah,  ah 

/Get  function  number  for  key 

int 

16h 

/Call  BIOS  keyboard  interrupt 

cmp 

al, "s" 

/Was  <s>  entered? 

je 

ende 

/YES  — >  End  program 

cmp 

al,"S" 

/Was  <S>  entered? 

jne 

startdemo 

/NO  — >  Start  demo 

ende: 

mov 

ax, 4C00h 

/Function  no.  for  end  program 

int 

21h 

/Call  DOS  interrupt  21H 

Initialize  graphic  mode  - 

startdemo 

label  near 

mov 

ax,GR  640  350 

/Initialize  64x350-pixel 

int 

lOh 

/16-color  graphic  mode 
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dl: 


d2: 

d3: 


demo 


mov 

ch, 000100001b 

/Color:  Blue 

mov 

ax, 350 

/Number  of  raster  lines:  350 

call 

fillscr 

/Fill  screen 

/ —  The  program  displays  two  squares  on  the  screens  (the 

/ —  second  is  really 

a  copy  of  the  first)  until  the  user 

/ —  presses  a  key  to 

end  the  program 

xor 

ch,  ch 

/Set  color  to  0 

mov 

ax, 100 

/Starting  line  of  first  square 

inc 

ch 

/Increment  color 

and 

ch,15 

/AND  bits  4  and  7 

mov 

bx,245 

/Starting  column  of  first  square 

call 

setpix 

/Set  pixel 

push 

cx 

/Save  color 

call  getpix 

/Get  pixel  color 

push  ax 

/Push  coordinates  onto  stack 

push  bx 

add 

bx, 100 

/Ccxnpute  position  of  second 

add 

ax, 100 

/ square 

call 

setpix 

/Set  pixel  of  copy 

pop 

bx 

/Return  coordinates  of  first  square 

pop 

ax 

pop 

cx 

/Get  color 

inc 

bx 

/Increment  column 

cmp 

bx,295 

/Reached  the  last  column? 

jne 

d3 

/NO  — >  Set  next  pixel 

inc 

ax 

/YES,  Increment  line 

cmp 

ax, 150 

/Reached  the  last  line? 

jne 

d2 

/NO  — >  Work  with  next  line 

mov 

ah,l 

/Read  keyboard 

Int 

16h 

/Call  BIOS  keyboard  interrupt 

je 

dl 

/No  key  pressed  — >  Continue 

mov 

ax,TX  80  25 

/ 80x25  text  mode 

int 

lOh 

/ Initialization 

jmp 

short  ende 

/End  programm 

endp 

Functions  used  in  the  demo  program  ***-===«**=«=*==> 


—  PIXPTR:  Computes  the  address  of  a  pixel  within  video  RAM  for  the 

new  EGA/ VGA  graphic  modes 

—  Input  :  AX  =  Graphic  line 

BX  =  Graphic  column 

—  Output  :  ES:BX  *  Pointer  to  the  byte  in  video  RAM  containing  pixel 

CL  =  Number  of  right  shifts  for  the  byte 

=  Number  of  byte  shifts  in  E5:BX  needed  to  isolate 
the  pixel 

AH  »  Bitmask  for  combining  with  all  other  pixels 

—  Registers:  ES,  AX,  BX  and  CL  are  changed^ 


pixptr  proc  near 


push 

dx 

mov 

cl,bl 

mov 

dx,  LINE 

mul 

dx 

shr 

bx,l 

shr 

bx,l 

LEN 


;Push  DX  onto  stack 

;Save  low  byte  of  graphic  column 
/Number  of  bytes  per  line  to  DX 
;AX  »  graphic  line  *  LINE_LEN 
/Shift  graphic  column  three  places  to 
/the  right,  divide  by  8 


533 


10.  Accessing  and  Programming  the  Video  Cards 


PC  System  Programming 


shr 

bx,l 

add 

bx,  ax 

/Add  line  offset 

mov 

ax,VIO_SEG 

/Load  segment  address  of  video  RAM 

mov 

es,ax 

/into  ES 

and 

cl,  7 

/And  bits  4  -  7  of  graphic 

column 

xor 

cl,  7 

/Turn  bits  0-3  then 
/subtract  7  -  CL 

mov 

ah,l 

/After  shift,  bit  0  should 
/left  alone 

be 

pop 

ret 

dx 

/Pop  DX  off  of  stack 
/Back  to  caller 

pixptr  endp 


—  SETPIX:  Sets  a 

—  Input  :  AX 

BX 

CH 


graphic  pixel  in  the  new  EGA/VGA  graphic  modes 
=  graphic  line 
=  graphic  column 
=  pixel  color 


—  Output  :  none 

—  Registers:  ES,  DX  and  CL  are  changed 


setpix  proc  near 


push  ax 
push  bx 


;Push  coordinates  onto 
;the  stack 


call  pixptr 


;Conputer  pointer  to  the  pixel 


mov  dx, GRAPH_CONT  /Load  port  addr.  of  graphic  controller 

; —  Set  bit  position  in  bitmask  register  - 


shl  ah, cl 

mov  al, BITMASK_REG 

out  dx, ax 


/Mask  for  bit  to  be  changed 
/Move  bitmask  register  from  AL 
/Write  to  register 


/ —  Set  read  mode  0  and  write  mode  2 


mov  ax,MODE_REG  +  (2  shl  8)  /Reg.  no.  and  ,mode  value 
out  dx, ax  /Write  in  the  register 

/ —  Define  comparison  mode  between  preceding  latch  - 

/ —  contents,  and  CPU  byte  - 

mov  ax,  FUNCSEL_REG  +  (OP_MaDE  shl  8)  /Write  register  number 
out  dx, ax  /and  comparison  operator 

/ —  Pixel  control  - 

mov  al,es:[bx]  /Load  latches 

mov  es:[bx],ch  /Move  color  into  bitplanes 

/ —  Set  altered  registers  to  their  default  (BIOS> - - - 

/ —  status  - 


mov 

ax,  BITMASK_REG  + 

(OFFh  shl  8)  /Set  old  bitmask 

out 

dx,  ax 

/Write  in  the  register 

mov 

ax,MODE_REG 

/Write  old  value  for  for  mode 

register 

out 

dx,  ax 

/into  register 

mov 

ah, FUNCSEL_REG 

/Write  old  value  for  function 

select 

out 

dx,  ax 

/register  into  register 
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pop  bx 
pop  ax 


Pop  coordinates  off  of  stack 
Back  to  caller 


setplx  endp 


—  GETPIX:  Places  a  pixel's  color  in  one  of  the  new  EGA/VGA 
graphic  modes 


— 

Input 

: 

AX  «  graphic  line 

— 

BX  =  graphic  column 

— 

Output  : 

CH  -  graphic  pixel  color 

— 

Registers: 

ES,  DX  ,  CX  and  DI  are  changed 

getpix 

proc 

near 

push 

ax 

;Push  coordinates  onto 

push 

bx 

;the  stack 

call 

pixptr 

;CcMnputer  pointer  to  pixel 

mov 

ch,  ah 

;Move  bitmask  to  CH 

shl 

ch,  cl 

/Shift  bitmask  by  bit  positions 

mov 

di,bx 

/Move  video  RAM  offset  to  DI 

xor 

bl,bl 

/Color  value  will  be  con?)uted  in  BL 

mov 

dx, GRAPH  CONT 

/Load  graphic  controller  port  address 

mov 

ax,MAPSEL_REG 

+  (3  shl  8)  /Access  bitplane  #3 

; —  Go  through  each  of  the  four  bit planes  - 

gpl 

out 

dx,  ax 

/Activate  bitplane  #AH  only 

mov 

bh,es: [di] 

/Get  byte  from  the  bitplane 

and 

bh,  ch 

/Omit  uninteresting  bits 

neg 

bh 

/Bit  7*1,  when  a  pixel  is  set 

rol 

bx,  1 

/Shift  bit  7  from  BH  to  Bit  1  in  BL 

dec 

ah 

/Decranent  bitplane  number 

jge 

gpl 

/Not  -1  yet?  — >  next  bitplane 

; —  The  map  select 

register  must  not  be  reset,  since 

; —  the  EGA-  and  VGA-BIOS  default  to  a  value  of  0 

mov 

ch,bl 

/Get  color  from  CH 

pop 

bx 

/Pop  coordinates  off 

pop 

ax 

/of  stack 

ret 

/Back  to  caller 

getpix 

endp 

; — 

FILLSCR:  Sets  all  screen 

pixels  to  one  color  - 

; — 

Input 

: 

AX  -  number  of  graphic  lines  on  the  screen 

;  — 

CH  =  pixel  color 

;  — 

Output  : 

none 

; — 

Registers : 

ES,  AX,  CX,  DI,  DX  and  BL  are  changed 

fillscr 

proc 

near 

mov 

dx, GRAPH  CONT 

/Load  graphic  controller  port  address 

mov 

al,SETRES  REG 

/Numixner  of  Set-/Reset  registers 

mov 

ah,  ch 

/Move  bit  canbination  to  AL 

out 

dx,ax 

/Write  to  the  register 

mov 

ax, ENABLE  REG 

+  (OFh  shl  8)  /Write  OFH  in  the 

out 

dx,ax 

/Enable  Set-/Reset  register 

mov 

bx,LINE  LEN  / 

2  /Length  of  a  graphic  line  /  2  into  BX 

mul 

bx 

/Multiply  by  number  of  graphic  lines 

mov 

CX,  ax 

/Move  to  CX  as  repeat  counter 

xor 

di,dl 

/Address  first  byte  in  video  RAM 

mov 

ax,VIO_SEG 

/Segment  address  of  video  RAM 
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mov  es,  ax 
cld 

rep  stosw 


;ljoad  Into  ES 

;Incr«rient  on  string  instructions 
;F111  video  RAM 


; —  Return  old  contents  of  Enable  Set-/Reset  register 


mov  dx, GRAPH_CONT 
mov  ax, ENABLE_REG 
out  dx, ax 


;Load  graphic  controller  port  address 
; Write  OOH  in  Enable  Set-/ 

; Reset  register 


ret 


/Back  to  caller 


fillscr  endp 
/“  End 


code  ends 

end  desno 


/End  of  code  segment 

/Start  program  execution  with  DEMO 
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10.6  Determining  the  Type  of  Video  Card 

Whenever  you  want  to  access  video  card  hardware  or  use  a  BIOS  function  which  is 
only  available  in  special  versions  of  the  BIOS,  you  should  first  ensure  that  the  card 
in  question  is  actually  installed  in  the  system.  If  your  program  doesn't  make  such  a 
test,  then  the  result  may  not  be  what  you  wanted  to  appear  on  the  screen. 

It  is  especially  important  for  an  application  program  to  recognize  the  type  of  video 
card  installed,  if  your  program  is  supposed  to  work  the  same  on  all  types  of  cards 
while  still  directly  accessing  video  hardware.  The  output  routines  need  this 
information  to  make  optimum  use  of  the  special  properties  of  the  given  card. 

Remember  that  the  PC  can  have  both  a  monochrome  video  card  (MDA,  HOC  or 
EGA  with  a  monochrome  monitor)  and  a  color  video  card  (EGA,  VGA,  or  CGA) 
installed,  although  only  one  of  the  two  cards  may  be  active  at  one  time. 


1  Combinations  allowable  for  PC  video  cards  | 

VGA 

EGA 

HGC 

CGA 

MDA 

VGA 

■ 

■ 

EGA 

■ 

■ 

■ 

HGC 

■ 

■ 

■ 

CGA 

■ 

■ 

■ 

MDA 

■ 

■ 

■ 

We  need  to  find  out  what  video  cards  are  installed.  There  are  no  BIOS  or  DOS 
functions  for  doing  this,  nor  are  there  any  variables  we  can  read.  We  have  to  write 
an  assembly  language  routine  which  checks  the  existence  of  different  video  cards. 
We  can  refer  to  the  documentation  (or  the  various  cards,  since  most  manufacturers 
include  some  procedure  for  determining  if  their  card  is  in  use.  It  is  important  to 
keep  the  test  specific  (i.e.,  it  does  not  return  a  positive  result  if  a  certain  type  of 
video  card  is  not  installed).  This  presents  problems  for  EGA  and  VGA  cards,  which 
can  emulate  CGA  or  MDA  cards  with  the  appropriate  monitor,  and  are  difficult  to 
distinguish  from  true  CGA  or  MDA  cards. 

All  of  the  tests  described  here  are  found  at  the  end  of  this  section  in  the  form  of 
two  assembly  language  programs  intended  for  use  with  C  and  Pascal  programs. 
The  functions  place  the  type  of  video  card  installed  and  the  type  of  monitor 
connected  to  it  into  an  array  to  which  the  function  is  passed  a  pointer.  If  two  video 
cards  are  installed,  their  order  in  the  array  indicates  which  one  is  active. 

The  following  cards  can  be  detected  by  the  assembly  language  routine: 

•  MDA  cards 

•  CGA  cards 

•  HGC  cards 
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•  EGAcaids 

•  VGAcaids 

Since  the  assembly  language  routine  checks  selectively  for  the  existence  of  a 
certain  video  card,  there  is  a  separate  subroutine  for  each  type  of  video  card.  It  bears 
the  name  of  the  video  card  for  which  it  tests.  These  routines  have  names  like 
TEST__EGA,  TEST_VGA,  etc.  The  tests  could  be  called  sequentially,  but  certain 
tests  can  be  excluded  if  we  know  they  would  return  a  negative  result  This  is  case 
for  the  CGA  test,  for  example,  if  an  EGA  or  VGA  card  has  already  been  detected 
and  is  connected  to  a  high-resolution  color  monitor.  A  CGA  card  cannot  be 
installed  alongside  such  a  card,  so  there  is  no  point  in  testing  for  it. 

There  is  a  flag  for  each  test  which  determines  whether  or  not  the  test  will  be 
performed.  Before  the  first  test,  the  VGA  test,  all  of  the  flags  are  set  to  1  so  that 
all  of  the  tests  will  be  performed  in  order.  During  the  testing,  certain  flags  can  be 
set  to  0  for  reasons  mentioned  above,  and  the  corresponding  tests  will  not  be  made. 

VGA  test 

The  tests  begin  with  the  VGA  test.  It  is  very  easy  because  there  is  a  special 
function  in  the  VGA  BIOS,  sub-function  OOH  of  function  lAH,  which  returns 
precisely  the  information  that  the  assembly  language  routine  needs.  The 
information  is  available  only  if  a  VGA  card  and  hence  a  VGA  BIOS  is  installed. 
This  is  the  case  if  the  value  1  AH  is  found  in  the  AL  register  after  the  call.  If  the 
test  routine  encounters  a  different  value  there,  the  VGA  test  will  be  terminated  and 
the  other  tests  will  be  performed.  This  indicates  that  a  VGA  card  is  not  installed. 

After  this  function  is  called,  the  BL  register  contains  a  special  device  code  for  the 
active  video  card  and  the  BH  regist^  contains  a  code  for  the  inactive  card.  The 
following  codes  can  occur 


Code 

Meaning 

OOH 

No  video  card 

OlH 

MDA  card/monochrome  monitor 

02H 

CGA  card/color  monitor 

03H 

Reserved 

04H 

EGA  card/high-resolution  monitor 

OSH 

EGA  card/monochrome  monitor 

06H 

Reserved 

07H 

VGA  card/analog  monochrome  monitor 

OSH 

VGA  card/analog  color  monitor 

These  codes  are  separated  into  values  for  the  video  card  and  the  monitor  connected 
to  it,  and  loaded  into  the  array  whose  address  is  passed  to  the  assembly  language 
routine.  Since  this  routine  already  has  information  about  both  video  cards,  the 
following  tests  do  not  have  to  be  p^ormed.  The  routine  executes  the  monochrome 
test,  however,  if  the  functions  discover  a  monochrome  card,  since  it  cannot 
distinguish  between  an  MDA  and  HGC  card. 
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EGA  test 

After  the  VGA  test  comes  the  EGA  test,  which  it  performed  only  if  the  VGA  test 
was  unsuccessful,  and  thus  the  EGA  flag  was  not  cleared.  It  uses  a  function  which 
is  found  only  in  the  EGA  BIOS:  sub-ftuiction  lOH  of  function  12H.  If  no  EGA 
card  is  installed  and  this  function  is  not  available,  the  value  lOH  will  still  be  found 
in  the  BL  register  afto*  the  function  call.  In  this  case  the  EGA  test  ends. 

If  an  EGA  card  is  installed,  the  CL  register  will  contain  the  settings  of  the  DIP 
switches  on  the  EGA  card  after  the  call.  These  switches  indicate  what  type  of 
monitor  is  connected.  They  are  converted  to  the  monitor  codes  the  assembly 
language  routine  uses  and  placed  in  the  array  along  with  the  code  for  the  EGA  canL 
The  CGA  or  monochrome  test  flag  is  cleared  depending  on  the  type  of  monitor 
connected.  The  EGA  routine  ends. 

CGA  test 

If  the  CGA  flag  has  not  been  cleared  by  the  previous  tests,  the  CGA  test  follows 
the  EGA  test.  As  with  the  monochrome  test,  there  are  no  special  BIOS  functions 
which  can  be  used  and  we  have  to  check  for  the  presence  of  the  appropriate 
hardware.  In  both  routines  this  is  done  by  calling  the  routine  TEST_6W5,  which 
tests  to  see  if  the  6845  video  controllo:  found  on  these  cards  is  at  the  specified  port 
address.  On  a  CGA  card  this  is  port  address  3D4H,  which  is  passed  to  the  routine 
TEST_6845. 

The  only  way  to  test  the  existence  of  the  CRTC  at  a  given  port  address  is  to  write 
some  v^ue  (other  than  0)  to  one  of  the  CRTC  registers  and  then  read  it  back 
immediately.  If  the  value  read  matches  the  value  written,  then  the  CRTC  and  thus 
the  video  card  are  present  But  before  writing  a  value  into  a  CRTC  register,  we 
should  stop  to  consider  that  these  registers  have  a  major  impact  on  the 
construction  of  the  video  signals  and  careless  access  to  them  can  not  only 
thoroughly  confuse  the  CRTC,  it  can  even  harm  the  monitor.  Registm  0  to  9  are 
out  of  the  question  for  this  test,  leaving  us  with  registers  10  to  IS,  all  of  which 
have  an  effect  on  the  screen  contrats.  The  best  we  can  do  is  regist^  10  and  11, 
which  control  the  starting  and  ending  lines  of  the  cursor. 

The  assembly  language  routine  Erst  reads  the  contents  of  register  10  before  it  loads 
any  value  into  this  register.  After  a  short  pause  so  that  the  CRTC  can  react  to  the 
ouQHit,  the  contrats  of  this  registo'  are  read  back.  B^oie  the  value  read  is  compared 
to  the  cuiginal  value,  the  old  value  is  first  written  back  into  the  register  so  that  the 
test  disturbs  the  screen  as  little  as  possible.  If  the  comparison  is  positive,  then  a 
CRTC  is  present  and  so  is  the  video  card  (CGA  in  this  case).  The  CGA  routine 
responds  by  loading  the  code  for  a  color  monitor  into  the  array,  since  this  is  the 
only  type  of  monitor  which  can  be  used  with  a  CGA  card. 
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Monochrome  test 

The  last  test  is  the  monochrome  test,  which  also  checks  fw  the  existence  of  a 
CRTC,  this  time  at  port  address  3B4H.  If  it  finds  a  CRTC  tho'e,  then  a 
monochrome  card  is  installed  and  we  have  to  figure  out  if  it  is  an  MDA  w  HGC 
hard.  The  status  registers  of  the  two  cards,  at  port  address  3BAH,  are  used  to 
determine  this.  While  bit  7  of  this  register  has  no  significance  on  the  MDA  card 
and  its  value  is  thus  undefined,  it  contains  a  1  on  an  HGC  card  whenever  the 
electron  beam  is  returning  across  the  screen.  Since  this  is  not  permanent  and 
occurs  only  at  intervals  of  about  two  milliseconds,  the  contents  of  this  bit 
constantly  altonates  between  0  and  1. 

Hercules 

The  test  routine  first  reads  the  contrats  of  this  register  and  masks  out  bits  0  to  6. 
The  resulting  value  is  used  in  a  maximum  of  32768  loop  passes,  where  the  value 
is  read  again  and  compared  with  the  original  value.  If  the  value  changes,  meaning 
that  the  state  of  bit  7  changes,  then  an  HGC  card  is  probably  installed.  If  this  bit 
does  not  change  over  the  course  of  32768  loop  passes,  then  an  MDA  card  is  in 
use. 

Here  again  we  place  the  appropriate  code  for  the  video  card  in  the  array.  The 
monitor  code  is  also  set  to  monochrome,  since  this  is  the  only  monitor  which  can 
be  connected  to  an  MDA  or  HGC  card. 

Primary  and  secondary  video  systems 

The  tests  are  now  over.  Now  we  have  to  figure  out  which  card  is  active  (primary) 
and  which  is  inactive  (secondary).  If  the  outcome  of  the  VGA  test  was  positive,  we 
can  skip  this  because  the  VGA  BIOS  routine  determines  the  active  card 
automatically. 

In  other  cases  we  can  detmnine  the  active  video  card  from  the  current  video  mode, 
which  can  be  read  with  the  help  of  function  OFH  of  the  BIOS  video  interrupt.  If 
the  value  seven  is  returned,  th^  the  80x2S  text  mode  of  the  monochrome  card  is 
active.  All  of  the  other  modes  indicate  that  a  CGA,  EGA,  or  VGA  card  is  active. 
This  information  is  used  to  exchange  the  order  of  the  two  entries  in  the  array  if  it 
does  not  match  the  actual  situation. 

The  assembly  language  routine  returns  control  to  the  calling  imrgram. 

Here  we  include  C  and  Pascal  programs  which  call  the  function  GetVIOS  from  the 
assembly  language  module,  and  demonstrate  how  GetVIOS  worts. 
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C  listing:  VIOSC.C 

/************************************************«*********************/ 


/*  V  I  0  s  c  */ 

/* - */ 

/*  Task  :  Determines  the  type  of  video  card  and  monitor  */ 

/*  installed  in  the  system.  */ 

/* - - - - - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  Developed  on  :  10/02/1988  */ 

/*  Last  update  :  06/20/1988  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  CL  /AS  /c  VIOSC.C  */ 

/*  LINK  VIOSC  VIOSCA  */ 

/*  Call  :  VIOSC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  Create  project  file  made  of  the  following:  */ 

/*  VIOSC  */ 

/*  VIOSCA. OBJ  */ 

/*  Info  :  Some  cards  may  return  errors  or  "unknown"  */ 

/**********************************************************************/ 

/★««  Declarations  of  external  functions  ™-««=««*/ 


extern  void  get__vios  (  struct  vios  *  ) ; 

/*=»  Type  defs  - - - 

typedef  unsigned  char  BYTE;  /*  Create  a  byte  */ 

struct  vios  {  /*  Describes  video  card  and  attached  monitor  */ 

BYTE  vcard, 
monitor; 

}; 


/★«*  Constants 


/* —  Constants  for  the  video  card 

fdefine  NO_VIOS  0 
fdefine  VGA  1 
fdefine  EGA  2 
fdefine  MDA  3 
fdefine  HGC  4 
fdefine  CGA  5 

/* —  Constants  for  monitor  type  — 

fdefine  NO_MON  0 
fdefine  MONO  1 
fdefine  COLOR  2 
fdefine  EGA_HIRES  3 
fdefine  ANLG_MONO  4 
fdefine  ANLG  COLOR  5 


- */ 

/*  No  video  card  */ 
/*  VGA  card  */ 
/*  EGA  card  */ 
/*  Monochrome  Display  Adapter  */ 
/*  Hercules  Graphics  Card  */ 
/*  Color  Graphics  Adapter  */ 

- */ 

/*  No  monitor  */ 
/*  Monochrome  monitor  */ 
/*  Color  monitor  */ 
/*  High-res/multisync  monitor  */ 
/*  Analog  monochrome  monitor  */ 
/*  Analog  color  monitor  */ 


/**********************************************************************y 

/**  MAIN  PROGRAM  **/ 

/  *****-k  ** -k  *********  ***  i,*  ****  itit  *****************************************  / 

void  malnO 


{ 

static  char  *vcnames[]  -  {  /*  Pointer  to  the  video  card  name  */ 

"VGA", 

"EGA", 
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-MDA-, 

"HGC, 

-CGA- 

); 


static  char  *monnames[]  =  {  /*  Pointer  to  the  monitor  type's  name  */ 

"monochrane  monitor", 

"color  monitor", 

"hlgh-res/multlsync  monitor", 

"analog  monochrome  monitor", 

"analog  color  monitor" 

In¬ 
struct  vlos  vsys[2];  /*  Vector  for  GET_VIOS  */ 

get_vlos (  vsys  );  /*  Determine  video  system  */ 

prlntf ("\nVIOSC  (c)  1988  by  Michael  Tlscher\n\n"); 
prlntf ("Primary  Video  System:  %s  card/  %s\n", 

vcnames[vsys[0] .vcard-1] ,  monnames [vsys [01 .monltor-1] ) ; 

If  (  vsys [1] .vcard  !=  NO_VIOS  )  /*  Is  there  secondary  video  system?  */ 

prlntf ("Secondary  Video  System:  %s  card/  %s\n", 

vcnames [vsys [1 ] . vcard-1 ] ,  monnames [vsys [1 ] .monltor-1 ] ) ; 

} 

Assembler  listing:  VIOSCA.ASM 


•*★★****************★★**★*★*******★*★****★*★**★★★****★**★***★★★*★★**★★★. 
;*  V  I  0  s  c  A  *; 


Task 

:  Creates  a  function  for  determining  video 
adapter  and  monitor  type,  when  linked  with 
a  C  program. 

★  • 

★  • 

★  • 

Author 

:  MICHAEL  TISCHER 

★  • 
/ 

Developed  on 

:  10/02/1988 

★  • 

Last  update 

:  06/20/1989 

★  • 

_ ★  • 

Assembly 

:  MASM  VIOSCA/ 

*  • 

t 

. . .  link  to  a  C  program 

*; 

.************★****★**********************************★****★*******★**★★. 


;==  Constants  for  VIOS  structure 


NO_VIOS 

0 

/Video  card  constants 
/No  video  card 

VGA 

= 

1 

/VGA  card 

EGA 

= 

2 

/EGA  card 

MDA 

= 

3 

/Monochrome  Display  Adapter 

HGC 

= 

4 

/Hercules  Graphics  Card 

CGA 

= 

5 

/Color  Graphics  Adapter 

NO  MON 

0 

/Monitor  constants 
/No  monitor 

MONO 

= 

1 

/Monochrcxne  monitor 

COLOR 

= 

2 

/Color  monitor 

EGA  HIRES 

= 

3 

/Hlgh-resolutlon  or  multisync  monitor 

ANLG  MONO 

* 

4 

/Analog  monochrome  monitor 

ANLG  COLOR 

= 

5 

/Analog  color  monitor 

Segment  declarations 


for  the 


C  program^’* 


IGROUP  group  _text  /Addition  to  program  segment 

DGROUP  group  const, Jdss,  _data  /Addition  to  data  segment 
assume  CS:IGR0UP,  DS:DGR0UP,  ES:DGROUP,  SS:DGROUP 


CONST  segment  word  public  'CONST' /This  segment  Includes  all  read-only 
CONST  ends  / constants 


BSS  segment  word  public  'BSS'  /This  segment  Includes  all 
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_BSS  ends  ;un-initialized  static  variables 

DATA  segment  word  public  'DATA'  ;Data  segment 


vios_tab  equ  this  byte 

; —  Conversion  table  for  return  values  of  function  lAH,  - 

; —  sub- function  OOH  of  the  VGA-BIOS  - 


db  NO_VIOS 
db  MDA 
db  CGA 
db  ? 
db  EGA 
db  EGA 
db  ? 
db  VGA 
db  VGA 


NO_MQN 

MONO 

COLOR 

7 

EGA_HIRES 

MONO 

7 

ANLG_MONO 
ANLG  COLOR 


;No  video  card 

;MDA  card  and  monochrome  monitor 
;CGA  card  and  color  monitor 
;Code  3  unused 
;EGA  card  and  hi-res  monitor 
;EGA  card  and  monochrome  monitor 
;Code  6  unused 

;VGA  card  and  analog  mono  monitor 
;VGA  card  and  analog  color  monitor 


egadips  equ  this  byte 

; —  Conversion  table  for  EGA  card  DIP  switch  settings 


db  COLOR,  EGA_HIRES,  MONO 
db  COLOR,  EGA_HIRES,  MONO 


_DATA  ends 

;  “  Program  »»==============:*==»==—===*===«=«> 

_TEXT  segment  byte  public  'CODE'  /Program  segment 
public  _get_vios 


—  GET_VIOS:  Determines  types  of  installed  video  cards  - 

—  Call  from  C  :  void  get_vios{  struct  vios  *vp  ); 

—  Declaration  :  struct  vios  {  BYTE  vcard,  monitor;  }; 

—  Return  value:  none 

—  Info  :  This  example  uses  function  in  SMALL  memory  model 


get_vlos  proc  near 


s frame 

struc 

cga_possl 

db  ? 

ega_possi 

db  ? 

mono_possi 

db  ? 

bptr 

dw  ? 

ret_adr 

dw  ? 

vp 

dw  ? 

s  frame 

ends 

frame 

equ 

[  bp  -  cga_possi  ] 

push 

bp 

sub 

sp,3 

mov 

sp 

push 

dl 

mov 

frame .  cga_possi,  1 

mov 

frame .  egajpossi,  1 

mov 

frame . mono_possi , ; 

mov 

di , frame . vp 

mov 

word  ptr  [di],NOJ 

mov 

word  ptr  [dl+2],N< 

; Stack  access  structure 
/Local  variable 
/Local  variable 
/Local  variable 
/Take  BP 

/Return  address  to  caller 
/Pointer  to  first  VIOS  structure 
/End  of  structure 

/Address  elements  of  the  structure 

/Push  BP  onto  stack 
/Allocate  space  for  local  variables 
/Transfer  SP  to  BP 
/Push  DI  onto  stack 

/Could  be  CGA 
/Could  be  EGA 
./Could  be  MDA  or  HGC 

/Get  offset  address  of  structure 
^lOS  /Still  no  video 
>_VIOS  ;  system  found 


call  testvga  /Test  for  VGA  card 

cmp  frame.ega_possi,0  /EGA  card  still  possible? 

je  gvl  /NO  — >  Test  for  CGA 
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call 

test  ega 

;Test  for  EGA  card 

gvl: 

cmp 

frame. cgaix>ss 1,0  ;CGA  card  still  possible 

je 

gv2 

;NO  — >  Test  for  MDA/HGC 

call 

test  cga 

;Test  for  CGA  card 

gv2; 

cmp 

frame. mono_possi, 0;MDA  or  HGC  card  still  posslbleh? 

je 

gv3 

;NO  — >  End  tests 

call 

test_mono 

•  ;Test  for  MDA/HGC  cards 

; —  Determine 

active  video  card  - 

gv3; 

cmp 

byte  ptr 

[dl],VGA  ;VGA  card  active? 

je 

gvl  end 

;YES,  active  card  already  determined 

cmp 

byte  ptr 

[dl+2],VGA  ;VGA  card  as  secondary  system? 

je 

gvljend 

;YES,  active  card  already  determined 

mov 

ah, OFh 

;Determlne  active  video  mode  using  the 

int 

lOh 

;BIOS  video  interrupt 

and 

al,7 

;Only  modes  0-7  are  of  Interest 

cmp 

al,7 

/Monochrone  card  active? 

jne 

gv4 

;N0,  In  CGA  or  EGA  mode 

MDA,  HGC, 

or  EGA  card  (mono)  is  active  - 

cmp 

byte  ptr 

[di+l],MONO  /Mono  monitor  in  first  structure? 

je 

gvl  end 

;YES,  Sequence  o.k. 

jmp 

short  switch  ;NO,  Change  sequence 

( 

CGA  or  EGA  card  currently  active  - 

gv4; 

cmp 

byte  ptr 

[dl+l],MONO  /Mono  monitor  in  first  structure? 

jne 

gvl_end 

/NO,  Sequence  o.k. 

switch; 

mov 

ax, [dl] 

/Get  contents  of  first  structure 

xchg 

ax,  [dl+2I 

/Exchange  with  second  structure 

mov 

[dl] ,ax 

gvl_end: 

pop 

dl 

/G-et  Dl  from  stack 

add 

sp,3 

/Get  local  variables  frcxn  stack 

pop 

bp 

/Get  BP  from  stack 

ret 

/Return  to  C  program 

get_vios  endp 


/ —  TEST_VGA:  Determines  whether  a  VGA  card  is  Installed 

test_vga  proc  near 

mov 

ax, laOOh 

/Function  lAH,  sub-function  OOH 

int 

lOh 

/calls  VGA-BIOS 

cmp 

al, lah 

/Is  this  function  suK>orted? 

jne 

tvga_end 

/NO  — >  End  routine 

; — 

If  function  is  supported,  BH  contains  the  active  video  — 

^  «... 

system  code/ 

BH 

contains  the  inactive  video  sys.  code  — 

mov 

cx,bx 

/Move  result  to  CX 

xor 

bh,bh 

/Set  BH  to  0 

or 

ch,  ch 

/Just  one  video  system? 

je 

tvga_l 

/YES  — >  Convey  first  system's  code 

/  ““ 

Convert  code 

of 

second  system  - 

mov 

bl,  ch 

/Move  second  syst&n  code  to  BL 

add 

bl,bl 

/Add  offset  to  table 

mov 

ax, offset  DGROUP:vios_tab[bx]  /Get  code  from  table  and 
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mov  [dl-i'2],ax  ;place  In  caller's  structure 

mov  bl,cl  ;lfove  first  system's  codes  to  BL 

; —  Convert  code  of  first  system  - 


tvga_l : 

add 

bl,bl 

;Add  offset  to  table 

mov 

ax, offset 

DGROUP:vlos_tab[bx]  ;Get  code  from  table  and 

mov 

[dl],ax 

/place  in  caller's  structure 

mov 

frame. cga_poss 1,0  ;CGA  test  failed 

mov 

frame. ega_poss 1,0  ;EGA  test  failed 

mov 

frame.inonojpossl,0  ;MCMO  still  needs  testing 

mov 

bx,di 

/Address  of  active  structure 

cmp 

byte  ptr 

[bx],MDA  /Monochrome  system  available? 

je 

do_tmono 

/YES  — >  Execute  MDA/HGC  test 

add 

bx,2 

/Address  of  inactive  structure 

cmp 

byte  ptr 

[bx],MDA  /Monochrome  system  available? 

jne 

tvga_end 

/NO  — >  End  routine 

do_tmono: 

mov 

word  ptr 

[bx],0  /Pretend  that  this  system 

/Is  still  unavailable 

mov 

frame.inono_possl,  1; Execute  monochrome  test 

tvga_end: 

ret 

/Back  to  caller 

test_vga 

endp 

; —  TEST__EGA:  Determines  whether  an  EGA  card  Is  Installed 


testjega 

proc 

near 

mov 

ah,12h 

/Function  12H 

mov 

bl,10h 

/Sub-function  lOH 

Int 

lOh 

/Call  EGA-BIOS 

cmp 

bl,10h 

/Is  the  function  supported? 

je 

tega_end 

/NO  — >  End  routine 

/ —  When  this 

function  is  supported,  CL  contains  the  EGA  - 

/ —  card's  DIP 

switch  settings  - 

mov 

ei,ci 

/Move  DIP  switch  settings  to  AL 

shr 

al,l 

/Shift  one  position  to  the  right 

mov 

bx, offset 

D6R0UP:ega__dlps  /Offset  address  of  table 

xlat 

/Move  element  AL  from  table  to  AL 

mov 

ah,al 

/Move  monitor  type  to  AH 

mov 

al,EGA 

/It's  an  EGA  card 

call 

found_lt 

/Move  data  to  vector 

cmp 

ah,  MONO 

/Connected  to  monochrome  monitor? 

je 

Isjnono 

/YES  — >  not  MDA  or  HGC 

mov 

frame. cgajpossi,0  /Cannot  be  a  CGA  card 

jmp 

short  toga_end  /End  routine 

Isjmono: 

mov 

frame.monojpossl,0/lf  EGA  card  is  connected  to  a  mono 

/monitor,  it  can  be  Installed  as 
/either  an  HGC  or  MDA 

tega_end: 

ret 

/Back  to  callerr 

testjega 

endp 

9 

; —  TEST__CGA:  Determines  whether  a  CGA  card  is  installed 
test_cga  proc  near 
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mov  dx, 3D4h 
call  test_6845 
jc  tega_end 

mov  al,CGA 
mov  ah, COLOR 
jmp  found_lt 

test_cga  endp 


;CGA  tests  port  addr.  of  CRTC  addr. 
;reg.,  to  see  if  6845  Is  installed 
;NO  — >  End  test 

;YES  — >  CGA  is  installed 
;CGA  has  color  monitor  attached 
/Transfer  data  to  vector 


; —  TEST_MC»JO:  Checks  for  the  existence  of  an  MDA  or  HGC  card 
test_mono  proc  near 

mov  dx,3B4h  /Check  port  address  of  CRTC  addr.  reg. 

call  test_6845  /with  MONO  to  see  if  there's  a  6845 

/installed 

jc  tega_end  /NO  — >  End  test 

/ —  If  there  is  a  monochrome  video  card  installed,  the  - 

/ —  following  determines  whether  it's  an  MDA  or  an  HGC  - 

mov  dl,0BAh  /Read  MONO  status  port  using  3BAH 

in  al,dx  / 

and  al,80h  /Check  bit  7  only  and 

mov  ah,al  /move  to  AH 

/ —  If  contents  of  bit  7  change  during  one  of  the  following  - 
/ —  readings,  the  card  is  handled  as  an  HGC 


mov 

cx,8000h 

/Maximum  of  32768  loop  executionse 

test_hgc: 

in 

al,dx 

/Read  status  port 

and 

al,80h 

/Check  bit  7  only 

cmp 

al,ah 

/Contents  changed? 

jne 

is_hgc 

/Bit  7  -  1  — >  HGC 

loop 

test_hgc 

/Continue  loop 

mov 

al,MDA 

/Bit  7  0  1  ~>  MDA 

jmp 

set_mono 

/Set  parameters 

is  hgc: 

mov 

al,HGC 

/Bit  7  -  1  — >  ist  HGC 

set_mono: 

mov 

ah,  MONO 

/MDA/HGC  on  mono  monitor 

jmp 

found_it 

/Set  parameters 

test_mono 

endp 

/—  TEST_6845: 


Sets  carry  flag  if  no  6845  exists  in  port  address  of  DX 


test  6845 


wait: 


proc 

near 

mov 

al,OAh 

/Register  10 

out 

dx,al 

/Register  number  of  CRTC  address  reg. 

inc 

dx 

/DX  now  in  CRTC  data  register 

in 

al,dx 

/Get  contents  of  register  10 

mov 

ah,al 

/and  move  to  AH 

mov 

al,4Fh 

/Any  value 

out 

dx,  al 

/Write  to  register  10 

mov 

cx,100 

/Short  delay  loop — gives  6845  time 

loop 

wait 

/to  react 

in 

al,dx 

/Read  contents  of  register  10 

xchg 

al,ah 

/Exchange  AH  and  AL 

out 

dx,al 

/Send  old  valuen 

cmp 

ah, 4Fh 

/Written  value  read? 
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je  t6845_end  ;yES  — >  End  test 

stc  ;N0  — >  Set  carry  flag 

t6845_end:  ret  ;Back  from  caller 

test_6845  endp 


—  FOUND_IT:  Transfers  video  card  type  to  AL  and  monitor  type  to  — - 

AH  in  the  video  vector  - 


found_it  proc  near 


mov  bx,di 

dtp  word  ptr  [bx],0 
je  set_data 


/Address  of  active  structure 
/Video  system  already  onboard? 
/NO  — >  Data  in  active  structure 


add  bx,2 


/YES,  Address  of  inactive  structure 


set_data:  mov  [bx],ax 
ret 


/Place  data  in  structure 
/Back  to  caller 


found_it  endp 


_text  ends  /End  of  code  segment 

end  /End  of  program 

listing:  VIOSP.PAS 

^ **********************************************************************  J 


{*  V  I  0  S  P  *} 

- *J 

{*  Task  :  Returns  the  type  of  video  card  installed.  *} 

(* - 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  Developed  on  :  10/02/1988  *} 

{*  Last  update  :  06/19/1989  *} 

(* - 

{*  Info  :  Scxne  of  the  values  given  here  may  not  coincide  *} 

with  some  video  cards  (e.g.,  scxne  CGA  cards 
{*  may  return  "Unknown  card") .  *} 


^ ***************** *****************************************************  j 

program  VIOSP/ 


{$L  c;\masm\viospa} 

{  Link  assenribler  module 

{  Change  path  to  suit  your  DOS  needs 

const  NO  VI OS 

=  0/ 

{  No  video  <»rd 

VGA 

“  1; 

{  VGA  card 

EGA 

=  2/ 

{  EGA  card 

MDA 

=  3/ 

{  Monochrcxne  Display  Adapter 

HGC 

=  4/ 

{  Hercules  Graphics  Card 

CGA 

=  5/ 

{  Color  Graphics  Adapter 

NO  MON 

=  0/ 

{  No  monitor 

MONO 

=  1; 

{  Monochrcxne  monitor 

COLOR 

=  2/ 

{  Color  monitor 

EGA__HIRES 

*  3/ 

{  High-resolution  monitor 

ANLG  MONO 

=  4/ 

{  Monochrcxne  analog  monitor 

ANLG  COLOR 

=  5/ 

{  Color  analog  monitor 

type  Vios  =  record 

{  Describes  video  c:ard  and  attached  monitor 

VCard, 

Monitor  : 

byte/ 

end/ 
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ViosPtr  »  ^Vios;  {  Pointer  to  a  VIOS  structure  } 

procedure  GetVios(  vp  :  ViosPtr  )  ;  external  ; 

var  VidSys  :  array [1.. 2]  of  Vios;  {  Array  containing  video  structures  } 

I  ********************************************************* *************) 


{*  PrintSys;  Gives  information  about  a  video  system  *} 

{*  Input  :  -  VCARD:  Code  number  of  the  video  card  *} 

i*  -  MC»J  :  Code  number  of  the  attached  monitor  *} 

Output  :  none  *} 


^  **********************************************************************} 

procedure  PrintSys (  VCard,  Mon  :  byte  ); 

begin 

write  ( •  ' ) ; 
case  VCard  of 

NO_VIOS  :  write ('Unknown') ;  {  For  "other"  code  ) 

VGA  :  write ('VGA'); 

EGA  :  write  ('EGA'); 

MDA  :  write  ('MDA'); 

CGA  :  write  (' CGA' )  ; 

HGC  ;  write  (' HGC  ); 
end; 

write ( '  card/  ' ) ; 
case  Mon  of 

NO_MON  :  write (' unknown  monitor');  {  For  "other"  monitors  } 

MONO  :  writeln( 'monochrome  monitor ') ; 

COLOR  :  writeln ( ' color  monitor ' ) ; 

EGA_HIRES  :  writeln ( 'high-resolution  monitor' ) ; 

ANLG_MONO  :  writeln ( 'monochrome  analog  monitor ') ; 

ANLG_COLOR  :  writeln (' color  analog  monitor'); 
end; 
end; 


^  **********************************************************************} 
{**  MAIN  PROGRAM  **} 

I  **********************************************************************  j 


begin 

GetVios(  @VidSys  );  {  Check  installed  video  card  } 

writeln CVIOSP  -  (c)  1988byMICHAELTISCHER'); 

write ('Primary  video  system:  '); 

PrintSys (  VidSys [1] .VCard,  VidSys [1] .Monitor  ); 
writeln (#13#10); 

if  VidSys [2] .VCard  <>  NO_VIOS  then  {  Second  video  system  installed?  ) 
begin  {  YES  } 

write ( ' Secondary  video  system: ' ) ; 

PrintSys (  VidSys [2] .VCard,  VidSys [2] .Monitor  ); 
writeln (#13#10); 
end; 

end. 


Assembler  listing:  VIOSPA.ASM 


. **********************************************************************; 
;*  V  I  0  s  p  A  *; 


Task 

:  Creates  a  function  for  determining  the  type 
of  video  card  installed  on  a  system.  This 
routine  must  be  assembled  into  an  OBJ  file, 
then  linked  to  a  Turbo  Pascal  (4.0)  program. 

Author 

:  MICHAEL  TISCHER 

Developed  on 

:  10/02/1988 

Last  update 

:  06/19/1989 

assembly 

:  MASM  VIOSPA; 
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;*  ...  Link  to  a  Turbo  Pascal  program  *; 
;*  using  the  {$L  VIOSPA}  coirpller  directive  *; 
.****★**★**************★***********************************************. 


Constants  for  the  VIOS  structure 


NO  VIOS 

a 

0 

/Video  card  constants 

/No  video  card/ unrecognized  card 

VGA 

- 

1 

/VGA  card 

EGA 

- 

2 

/EGA  card 

MDA 

- 

3 

/Monochrome  Display  Adapter 

HGC 

- 

4 

/Hercules  Graphics  Card 

CGA 

5 

/Color  Graphics  Adapter 

NO  MON 

0 

/Monitor  constants 

/No  monitor /unrecognized  code 

MONO 

- 

1 

/Monochrome  monitor 

COLOR 

» 

2 

/Color  Monitor 

EGA_HIRES 

* 

3 

/ High- resolution/multisync  nranitor 

ANLG  MONO 

* 

4 

/Monochrcme  analog  monitor 

ANLG_COLOR 

s 

5 

/Analog  color  monitor 

/««  Data  s< 

sgr 

nent  »=«=»= 

- , - - - 

DATA  segment  word  public  /Turbo  data  segment 

DATA  ends 


Code  segment 


CC®E  segment  byte  public  /Turbo  code  segment 

assume  cs:CCX)E,  ds:DATA 
public  getvios 

/ —  Initialized  global  variables  must  be  placed  in  the  code  segment  - 


vios_tab  equ  this  word 


/ —  Conversion  table  for  supplying  return  values  of  VGA  - 

/ —  BIOS  function  lA(h),  sub-function  00(h)  - 


db  NO_VIOS, 
db  MDA  , 
db  CGA  , 
db  ?  , 
db  EGA  , 
db  EGA  , 
db  ?  , 
db  VGA  , 
db  VGA  , 


NO_MON 

MONO 

COLOR 

o 

EGA_HIRES 

MONO 


/No  video  card 

/MDA  card/monochrcxne  monitor 
/CGA  card/ col or  monitor 
/Code  3  unused 
/EGA  card/hl-res  monitor 
/EGA  card/monochrome  monitor 


?  /Code  6  unused 

ANLG_MONO  /VGA  card/analog  mono  monitor 

ANLGjCOLOR  /VGA  card/analog  color  monitor 


ega_dips  equ  this  byte 


/ —  Conversion  table  for  EGA  card  DIP  switches 


db  COLOR,  EGA_HIRES,  MONO 
db  COLOR,  EGA_HIRES,  MONO 


/ —  GETVIOS:  Determines  type(s)  of  installed  video  card(s)  - 

/ —  Pascal  call  :  Getvios  (  vp  :  ViosPtr  )/  external/ 

/ —  Declaration  :  Type  Vios  =  record  VCard,  Monitor:  byte/ 

/ —  Return  Value:  None 

getvios  proc  near 

sframe  struc  /Stack  access  structure 

cga__possl  db  ?  /local  variables 
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ega_possi 

db  ? 

/local  variables 

inono_possi  db  ? 

/local  variables 

l:^tr 

dw  ? 

;BPTR 

ret  adr 

dw  ? 

/Return  address  of  calling  program 

vp 

dd  ? 

/Pointer  to  first  VIOS  structure 

sframe 

ends 

/End  of  structure 

frame 

equ 

[  bp  -  cga_possi  ] 

/Address  elements  of  structure 

push 

bp 

/Push  BP  onto  stack 

sub 

sp,3 

/Allocate  monory  for  local  variables 

mov 

bp,sp 

/Transfer  SP  to  BP 

mov 

frame . cga_possi , 1 

/Is  it  a  CGA? 

mov 

frame . ega_possi , 1 

/Is  it  an  EGA? 

mov 

frame .mono_possi , ] 

./Is  it  an  MDA  or  HGC? 

mov 

di,word  ptr  frame. 

,vp  /Get  offset  addr.  of  structure 

mov 

word  ptr  [di],NO  VIOS  ;No  video  system  or  un)cnown 

mov 

word  ptr  [di+2] ,NO_VIOS  /system  found 

call 

test  vga 

/Test  for  VGA  card 

cmp 

frame . ega_possi , 0 

/Or  is  it  an  EGA  card? 

je 

gvl 

/NO  — >Go  to  CGA  test 

call 

test  ega 

/Test  for  EGA  card 

gvl; 

Clip 

frame . cga_possi , 0 

/Or  is  it  a  CGA  card? 

je 

gv2 

/NO  ~>  Go  to  MDA/HGC  test 

call 

test  cga 

/Test  for  CGA  card 

gv2: 

cirp 

frame  .mono_possi ,  C 

);Or  is  it  an  MDA  or  HGC  card? 

je 

gv3 

/NO  — >  End  tests 

call 

test  mono 

/Test  for  MDA/HGC  card 

; —  Determine  video  configuration  - 

gv3: 

cnp 

byte  ptr  [di],VGA 

/VGA  card? 

je 

gvi  end 

/YES  — >  Active  card  already  indicated 

cmp 

byte  ptr  [di+2] , VGA; VGA  card  part  of  secondary  system? 

je 

gvi_end 

/YES  — >  Active  card  already  indicated 

mov 

ah,0Fh 

/Determine  video  mode  using  BIOS  video 

int 

lOh 

/interrupt 

and 

al,7 

/Only  modes  0-7  are  of  interest 

cmp 

al,7 

/Mono  card  active? 

jne 

gv4 

;N0  — >  CGA  or  EGA  mode 

; —  MDA,  HGC  or  EGA  card  (mono)  currently  active  - 

dip 

byte  ptr  tdi+l],MC»IO  /Mono  monitor  in  first  structure? 

je 

gvi  end 

/YES,  Sequence  o.k. 

jmp 

short  switch 

/NO,  Switch  sequence 

; —  CGA  or  EGA  card  currently  active  - 

gv4: 

dip 

byte  ptr  [di+1] ,MCWO  /Mono  monitor  in  first  structure? 

jne 

gvi_end 

/NO  — >Sequence  o.k. 

switch: 

mov 

ax, [di] 

/Get  contents  of  first  structure 

xchg 

ax, [di+2] 

/Switch  with  second  structure 

mov 

[di],ax 

gvi_end: 

add 

sp,3 

/Add  local  variables  from  stack 

pop 

bp 

/Pop  BP  off  of  stack 

ret 

4 

/Clear  variables  off  of  stack; 

/Return  to  Turbo 

getvios 

endp 
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; —  TEST_VGA:  Determines  whether  a  VGA  card  is  installed 
test_vga  proc  near 

mov  ax, laOOh  /Function  lA(h),  sub-function  00(h) 

int  lOh  /Call  VGA-BIOS 

cmp  al,lah  /Function  supported? 

jne  tvgajend  /NO  — >  End  routine 

/ —  If  function  is  supported,  BL  contains  the  code  of  the  - 

/ —  active  video  system,  while  BH  contains  the  code  of  - 

/ —  the  inactive  video  syst^  - 

mov  cx,bx  /Move  result  in  CX 

xor  bh,bh  /Set  BH  to  0 

or  ch,ch  /Only  one  video  system? 

je  tvga_l  /YES  — >  Display  first  systen's  code 

/ —  Convert  code  of  second  system  - 

mov  bl,ch  /Move  second  system's  code  to  BL 

add  bl,bl  /Add  offset  to  table 

mov  ax,vios_tab[bx]  /Get  code  frcan  table  and  move  into 

mov  [di+2],ax  /caller's  structure 

mov  bl,cl  /Move  first  system's  code  into  BL 

/ —  Convert  code  of  second  system  - 

tvga_l:  add  bl,bl  /Add  offset  to  table 

mov  ax,vios_tab[bx]  /Get  code  from  table 

mov  [di],ax  /and  move  into  caller's  structure 

mov  frame.cga_jpossi,0  /CGA  test  fail? 
mov  frame.ega_j)ossi,0  /CGA  test  fail? 
mov  frame.monojpossi,  0  /Test  for  mono 

mov  bx,di  /Address  of  active  structure 

cmp  byte  ptr  [bx],MDA  /Monochrome  system  online? 
je  do_tmono  /YES  — >  Execute  MDA/HGC  test 

add  bx, 2  /Address  of  inactive  structure 

cmp  byte  ptr  [bx],MDA  /Monochrome  system  online? 
jne  tvgajend  /NO  — >  End  routine 

do_tmono:  mov  word  ptr  [bx],0  /Emulate  if  this  system 

/isn't  available 

itKJV  frame.monojpossi,  1/ Execute  monochrome  test 
tvga_end:  ret  /Return  to  caller 

test_vga  endp 


/ —  TEST_EGA:  Determine  whether  an  EGA  card  is  installed 

test_ega  proc  near 

mov  ah,12h  /Function  12(h) 

mov  bl,10h  /Sub-function  10(h) 

int  lOh  /Call  EGA-BIOS 

cmp  bl,10h  /Is  this  function  supported? 

je  tega_end  /NO  — >  End  routine 

/ —  If  the  function  IS  supported,  CL  contains  the  - 

/ —  EGA  card  DIP  switch  settings  - 

mov  bl,cl  /Move  DIP  switches  to  BL 

shr  bl,l  /Shift  one  position  to  the  right 

xor  bh,bh  /Index  high  byte  to  0 
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mov  ah,ega_dips[bx]  ;Get  element  fran  table 

mov  al,EGA  ;Is  it  an  EGA  card? 

call  found_lt  /Transfer  data  to  the  vector 

cnp  ah^MMJO  /Mono  monitor  connected? 

je  isjnono  /YES  — >  Not  MDA  or  HGC 

mov  frame. cga_possi,0  /No  CGA  card  possible 

jmp  short  tega_end  /End  routine 

isjnono:  mov  frame.mono_possi,0/EGA  can  either  emulate  MDA  or  HGC, 

/if  mono  monitor  is  attached 


tega_end: 

ret 

/Back  to  caller 

test_ega 

endp 

TEST_ 

CGA:  Determines  whether 

a  CGA  card  is  installed 

test_cga 

proc 

near 

mov 

dx, 3D4h 

/Port  addr.  of  CGA's  CRTC  addr.  reg. 

call 

test  6845 

/Test  for  installed  6845  CRTC 

jc 

tega_end 

/NO  — >  End  test 

mov 

al,CGA 

/YES,  CGA  installed 

mov 

ah, COLOR 

/CGA  uses  color  monitor 

jnp 

found_it 

/Transfer  data  to  vector 

test_cga 

endp 

/ —  TEST_^ 

MONO: 

Checks  for 

MDA  or 

HGC  card 

testjnono 

proc 

near 

mov 

dx, 3B4h 

/Port  addr.  of  MC»IO's  CRTC  addr.  reg. 

call 

test  6845 

/Test  for  installed  6845  CRTC 

jc 

tegaend 

/NO  “>  End  test 

Monochrcxne 

video 

card  Installed 

mov 

dl,0BAh 

/MC»JO  status  port  at  3BA(h> 

in 

al,dx 

/Read  status  port 

and 

al, 80h 

/Separate  bit  7  and 

mov 

ah,al 

/move  to  AH 

; — 

If  the  contents  of  bit  7  in  the  status  port  change  - 

; — 

during  the 

following  readings,  it  is  handled  as  an  - 

r 

HGC 

— 

mov 

cx, 8000h 

/maximum  32768  loop  executions 

test_hgc: 

in 

al,dx 

/Read  status  port 

and 

al,80h 

/Isolate  bit  7 

cmp 

al,ah 

/Contents  changed? 

jne 

is  hgc 

/Bit  7  =  1  — >  HGC 

loop  test_hgc 

/Continue 

mov 

al,MDA 

/Bit  7  <>  1  “>  MDA 

jmp 

setjnono 

/Set  parameters 

is_hgc: 

mov 

al,HGC 

/Bit  7  »  1  — >  HGC 

setjnono; 

mov 

ah,  MONO 

/MDA  and  HGC  set  as  mono  screen 

jmp 

found_lt 

/Set  parameters 

testjnono  endp 

TEST_6845:  Returns  set  carry  flag  if  6845  doesn't  lie  in  the 
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port  address  in  DX 


test_6845 

proc 

near 

mov 

out 

inc 

al,0Ah 

dx,al 

dx 

; Register  10 

; Register  number  in  CRTC  address  reg. 
;DX  now  in  CRTC  data  register 

in 

mov 

al^dx 

ah,al 

;Get  contents  of  register  10 
;and  move  to  AH 

mov 

out 

al,4Fh 

dx,al 

;Any  value 

;Write  to  register  10 

wait: 

mov 

loop 

cx,100 

wait 

; Short  wait  loop  to  which 
;6845  can  react 

in 

xchg 

out 

al,dx 

al,ah 

dx,al 

;Read  contents  of  register  10 
; Exchange  Ah  and  AL 
;Send  value 

cup 

je 

ah, 4Fh 
t6845_end 

; Written  value  been  read? 

;YES  — >  End  test 

stc 

;NO  — >  Set  carry  flag 

t6845__end: 

ret 

;Back  to  caller 

test_6845 

endp 

—  FCXJND_IT:  Transfers  type  of  video  card  to  AL  and  type  of 
monitor  in  AH  in  the  video  vector 


found_it  proc  near 


roov  bx,di  ; Address  of  active  structure 

cnp  word  ptr  [bx],0  ;Video  system  already  onboard? 
je  setjdata  ;N0  — >  Data  in  active  structure 

add  bx,  2  ;YES  — >  Address  of  inactive  structure 


set_data;  mov  [bx],ax 
ret 


; Place  data  in  structure 
;Back  to  caller 


found_lt  endp 


code  ends 

end 


;End  of  code  segment 
;End  of  program 
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10.7  Accessing  Video  RAM  from  High  Level  Languages 

The  beginning  of  this  chapter  mentioned  the  option  of  video  RAM  access  from 
high  level  languages.  This  would  allow  the  ^veloper  to  write  screen  output 
routines  for  high  level  languages  that  would  execute  faster  than  output  commands 
available  to  the  languages,  BIOS  functions,  or  DOS  functions.  This  option  would 
be  particularly  attractive  if  it  meant  that  we  could  write  these  routines  without 
assembly  language  programming. 

The  demonstration  programs  below  implement  direct  video  RAM  access  routines 
which  display  a  string  on  the  screen.  Althrough  there  are  some  major  differences 
between  the  three  programs  as  a  result  of  the  differences  between  the  respective 
languages  (BASIC,  Pascal  and  C),  all  three  programs  contain  the  same  elements. 

Initialization 

Each  program  includes  an  initialization  routine  which  determines  the  segment 
address  of  the  video  RAM.  The  routine  has  a  variable  which  contains  the  address  of 
the  CRTC  address  register.  There  is  a  direct  relationship  between  the  video  RAM 
and  this  address  register:  just  as  this  register  is  always  at  port  address  3B4H,  the 
video  RAM  on  a  monochrome  card  is  always  found  at  segment  address  BOOOH. 
This  combination  also  applies  to  color  cards,  where  the  address  register  is  at  port 
address  3D4H  and  the  video  RAM  is  at  segment  address  BSOOH.  If  we  know  the 
port  address  of  the  CRTC  address  register,  we  can  determine  the  segment  address  of 
the  video  RAM.  Once  we  have  determined  this  address,  we  can  place  it  in  a  global 
variable  and  execute  the  initialization  routine. 


Output 


All  three  programs  have  an  output  routine  which  uses  the  segment  address  we 
determined  above.  Each  time  the  routine  displays  something,  it  determines  the 
starting  address  of  the  video  page  currently  displayed  on  the  screen.  This  ensures 
that  the  output  appears  on  the  visible  screen,  and  not  on  an  undisplayed  video 
page.  We  can  find  this  from  the  CRT__START  BIOS  variable.  This  variable  is 
located  at  address  0040:004E,  and  specifies  the  offset  address  of  the  displayed  video 
page  relative  to  the  video  page  found  at  offset  address  OOOOH. 

After  this  address  is  determined,  we  can  access  the  video  RAM.  The  method  used  in 
the  program  depends  on  the  given  programming  language.  Let’s  look  at  each 
program  in  more  detail. 

The  C  implementation 

From  a  programming  point  of  view,  this  is  the  cleanest  of  the  three 
implementations  because  the  video  RAM  can  be  treated  as  a  normal  variable  in  C. 
We  first  define  the  structure  VELB,  which  describes  the  ASCII/attribute  pair  as  it 
appears  in  the  video  RAM.  We  create  a  new  data  type,  VP,  to  act  as  a  pointer  to 
this  structure.  It  is  important  that  this  pointer  be  of  type  FAR  because  these 
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structures  are  in  the  video  RAM  and  thaefore  outside  the  C  data  segmm.  Smaller 
memory  models  in  C  require  the  declaration  of  this  pointer  as  a  FAR  pointer. 

The  global  variable  VPTR  is  initialized  to  be  a  pointer  to  the  first  ASCIl/attribute 
pair  in  page  0  of  the  video  RAM.  This  occurs  in  the  INIT_DPRINT  routine.  It  is 
used  within  the  DPRINT  function  (the  function  used  for  display)  as  the  basis  for 
addressing  the  characters  within  the  video  RAM. 

The  DPRINT  function  loads  the  LPTR  pointer  with  the  address  of  the  screen 
output  position  passed  to  the  routine.  LPTR  is  first  loaded  with  the  contents  of  the 
global  variable  VPTR,  and  then  with  the  offset  address  of  the  active  video  page,  as 
found  in  the  CRT_START  BIOS  variable.  IJ*TR  must  be  cast  as  a  BYTE  pointer 
because  the  contents  of  the  BIOS  variable  refers  to  bytes,  and  not  to  VELB 
structures.  If  the  cast  operator  were  missing,  the  C  compiler  would  generate  code 
which  would  first  multiply  the  contents  of  the  BIOS  variable  by  the  length  of  the 
VELB  structure  before  ^ding  it,  resulting  in  the  wrong  value. 

We  can  now  add  the  display  position  to  this  pointer.  The  output  position  is  passed 
to  DPRINT  as  row  and  colunm  coordinates.  The  video  RAM  is  treated  as  an  array 
of  2000  components,  each  of  which  is  a  VELB  structure.  Since  we  have  computed 
the  base  address  of  the  array  in  LPTR,  all  we  need  is  to  index  into  it.  We  multiply 
the  row  coordinate  by  80  (columns  per  line)  and  then  add  the  column  coordinate. 
Finally  we  have  a  pointer  to  the  output  position  in  video  RAM,  which  we  can 
treat  like  any  other  C  pointer. 

Each  time  through,  the  loop  increments  the  pointer  to  the  next  VELB  structure. 
We  write  the  ASCII  code  of  the  character  and  the  color  passed  to  DPRINT  to  the 
specified  address.  This  repeats  until  the  program  reaches  die  end  of  the  string. 

C  listing:  DVIC.C 

/*********************************  ********ic**1r***  ***************  *******  f 


/*  D  V  I  C  */ 

/* - */ 

/*  Task  :  Demonstrates  direct  access  to  video  RAM.  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  Developed  on  :  10/01/1988  */ 

/*  Last  update  :  06/21/1989  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  CL  /AS  DVIC.C  */ 

/*  Call  :  DVIC  */ 

/* - 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  RUN  menu  coiranand  (no  project  file  needed)  */ 

/**********************************************************************/ 


# include  <dos.h> 
♦include  <stdlib.h> 
♦include  <string.h> 
♦include  <stdarg.h> 
♦include  <blos.h> 
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/♦«*  Type  definitions 


typedef  unsigned  char  BYTE;  /*  Create  a  byte  */ 
typedef  struct  velb  far  *  VP;  /*  VP  »  FAR  pointer  in  video  RAM  */ 
typedef  BYTE  BOOL;  /*  similar  to  BOOLEAN  in  Pascal  */ 


/*—  Structures 


struct  velb  {  /*  Describes  a  2-byte  position  on  the  screen  */ 

BYTE  character,  /*  ASCII  code  */ 

attribute;  /*  Character  attribute  */ 

}; 


/* —  MK_FP  creates  a  FAR  pointer  to  an  object  from  a  segment  - */ 

/* —  address  and  offset  address  - */ 


#ifndef  MK_FP  /*  MK__FP  not  defined  yet?  */ 

♦define  MK_FP  (seg,  ofs)  ((void  far  *)  ((unsigned  long)  (seg)«161  (ofs) ) ) 
#endif 


♦define  COLOR  (VG,  HG)  ( (VG  «  3)  +  HG) 

♦define  TRUE  1  /*  Constants  for  use  with  BOOL  */ 

♦define  FALSE  0 


/* —  The  following  constants  return  pointers  to  variables  from  the  - */ 

/★ —  BIOS  variable  segment  at  segment  address  0x40  - */ 


♦define  CRT_START  ((unsigned  far  *)  MK_FP(0x40,  0x4E)) 
♦define  ADDR_6845  ( (unsigned  far  *)  MK_FP (0x40,  0x63) ) 


♦define  NORMAL  0x07 
♦define  BRIGHT  OxOf 
♦define  INVERSE  0x70 
♦define  UNDERSCORED  0x01 
♦define  BLINKING  0x80 


/*  Character  attribute  definition  */ 
/*  Based  on  monochrome  video  card*/ 


♦define 

BLACK 

0x00 

♦define 

BLUE 

0x01 

♦define 

GREEN 

0x02 

♦define 

COBALTBLUE 

0x03 

♦define 

RED 

0x04 

♦define 

VIOLET 

0x05 

♦define 

BROWN 

0x06 

♦define 

LIGHTGRAY 

0x07 

♦define 

DARKGRAY 

0x01 

♦define 

LIGHTBLUE 

0x09 

♦define 

LIGHTGREEN 

OxOA 

♦define 

LIGHTCOBALT 

OxOB 

♦define 

LIGHTRED 

OxOC 

♦define 

LIGHTVIOLET 

OxOD 

♦define 

YELLOW 

OxOE 

♦define 

WHITE 

OxOF 

/*  Color  attributes  for  color  card  */ 


/*“*  Global  variables 


VP  vptr; 


/*  Pointer  to  first  character  in  video  RAM  */ 


/★**★***★★**★*******★*★★★★******★*****★*★*★*★★*★*★*★*★**★***★★*★***★★★*★ 
*  Function  :  D  P  R  I  N  T  * 

★* - ** 


*  Task 


Writes  a  string  directly  to  video  RAM 


*  Input  parameters  ;  -  COLUMN 

*  -  LINES 

*  -  COLOR 


*  Output  column 

*  Output  row 

=  Character  attribute 


* 
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*  -  STRING  -  Pointer  to  string  * 

*  Return  value  :  None  * 

it -k*  **-k-k**it*  if  **************  *************** -k-kifk-kitifli  *************** -k-kic-klticit  / 


void  dprint (BYTE  column,  BYTE  lines,  BYTE  color,  char  *  string) 

{ 

register  VP  Iptr;  /*  Floating  pointer  in  video  RAM  */ 

register  BYTE  i;  /*  Points  to  number  of  characters  */ 

/* —  Set  pointer  to  output  position  in  video  RAM - - - */ 

Iptr  »  (VP)  ((BYTE  far  *)  vptr  +  *CRT__START)  +  lines  *  80  +  column; 
for  (i-0  ;  ^string  ;  ++lptr,  ++i)  /*  Execute  string  */ 

{ 

lptr->character  -  * (string++) ;  /*  Character  in  video  RAM  */ 

lptr->attribute  -  color;  /*  Set  character  attribute  */ 

} 

} 

/*********************************************************************** 


*  Function  :INIT_DPRINT  * 

*★ _ ** 

*  Task  :  Determines  video  RAM  segment  address  for  DPRINT  * 

*  Input  parameters  :  None  '  * 

*  Return  value  :  None  * 

*  Info  :  Allocates  segment  address  of  video  RAM  in  VPTR  * 

*  global  variable  * 


***********************************************************************/ 


void  initjdprlnt  () 

{ 

vptr  =  (VP)  MK_FP(  (*ADDR_6845  =-  0x3B4)  ?  OxBOOO  :  0xB800,  0  ); 

} 

/*********************************************************************** 


*  Function  :  C  L  S  * 

*★ _ ** 

*  Task  :  Clears  the  screen  with  the  help  of  DPRINT  * 

*  * 


*  Input  parameters  :  -  COLOR  *  Character  attribute  * 

*  Return  value  :  None  * 

*********************************************************************** f 


void  cls(  BYTE  color  ) 


{ 

static  char  blankline [81]  » 
(  •  ^ 


register  BYTE  i; 

for  (i-0;  i<24;  ++i) 
dprint (0,  i,  color,  blankline); 

} 


/*  Loop  counter  */ 

/*  Execute  each  line  */ 
/*  Display  blank  line  */ 


/*********************************************************************** 


*  Function 


N  0  K  E  Y 


Task 

Input  parameters 
Return  value 


Tests  for  a  keypress 
None 

TRUE  if  a  key  is  pressed,  otherwise  FALSE 


********************************************************* 
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BOOL  nokeyO 


{ 

ilfdef  _TURBOC_ 
return (  bioskey(  1  )  0  ); 

false 

return  (  _bios_keybrd  (  _KEyBRD_READy 
iendlf 
} 


/*  Compiling  this  with  TURBO  C?  */ 
/*  YES,  read  keyboard  frcwi  BIOS  */ 
/*  Using  Microsoft  C  */ 
)  *»  0  );  /*  Read  from  BIOS  */ 


/**********  **1t**1t*-k 

/**  MAIN  PROGRAM  **/ 

/★★★★*★★★*★★**★*★*★★★★★*******★*****★****★**********★★**********★******/ 


void  mainO 
{ 

BYTE  first col, 
color, 
column, 
lines; 


/*  Color  of  first  square  on  the  screen  */ 
/*  Color  of  current  square  */ 
/*  Current  output  position  */ 


lnit_dprint  0 ;  /*  Determine  segment  address  of  video  RAM 

cls(  COLOR  (BLACK,  GREEN)  ) ;  /*  Clear  screen 

dprlnt(22,  0,  WHITE,  "DVIC  -  (c)  1988  by  Michael  Tischer") ; 
flrstcol  -  BLACK  ;  /*  Start  with  black 

while (  nokey  0  )  /*  Repeat  until  the  user  presses  a  key 

{ 


if  (++firstcol  >  WHITE) 
first col  »  BLUE; 
color  *  first col; 


/*  Reached  last  color? 
/*  YES,  continue  with  blue 
/*  Set  first  color  on  the  screen 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


/★ —  Fill  screen  with  squares 


■*/ 


for  (  column*0;  column  <  80;  column  +=  4) 
for  (lines=l;  lines  <  24;  lines  +«  2) 

(  _ 

dprlnt(  column,  lines,  color,  •*■■■'•);/*  Block  characters  can  */ 
dprint  (  column,  lines+1,  color,  "■■■'');/*  be  created  by  press-  */ 
color  =  ++color  &  15;  /*  ing  <Alt><2><l><9>  */ 

} 

} 


The  Pascal  implementation 

By  using  the  keyword  ABSOLUTE  or  by  linking  in  a  small  assemblyx  language 
routine  it  would  also  be  possible  to  treat  the  video  RAM  as  a  normal  variable  in 
Turbo  Pascal.  But  there's  an  easier  way. 

Turbo  Pascal  offers  the  arrays  MEMW  and  MEM  for  accessing  memory  which  is 
outside  of  the  data  segment  of  the  Turbo  Pascal  program.  The  array  MEM  consists 
of  bytes  and  the  array  MEMW  of  words.  The  two  arrays  don't  actually  exist  and  are 
just  mapped  to  the  address  space,  but  that  doesn't  affect  their  usefulness. 

We  can  write  values  into  the  array  as  well  as  read  from  it.  This  is  done  with  the 
following  statement: 

MEMW[  segment  address  ;  offset  address  ]  :=  expression 


or 


variable  :=  MEMW[  segment  address  :  offset  address  ] 
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The  MEM  airay  might  be  easier  to  use  for  this  particular  application  since  we  will 
be  alternating  between  ASCII  characters  and  a  constant  attribute.  However,  the 
output  procedure  DPrint  uses  the  MEMW  array  instead,  because  16-bit  accesses  are 
perfnrned  faster  than  two  successive  8-bit  accesses  on  16-bit  machines. 

When  accessing  the  MEMW  array,  DPrint  takes  the  segment  address  of  the  vidra 
RAM  from  the  variable  VSeg,  which  is  initialized  at  the  start  of  the  program  in 
the  procedure  InitDPrint.  As  described  before,  this  is  done  by  examining  the  BIOS 
variable  which  contains  the  port  address  of  the  CRTC  address  register.  This  and  the 
other  BIOS  variables  are  declared  using  the  ABSOLUTE  keyword,  allowing  them 
to  be  used  in  the  program  like  any  other  global  variables. 

The  offset  within  the  MEMW  array  is  computed  fiom  the  starting  address  of  the 
screen  page.  The  coordinates  are  passed  to  DPrint,  in  which  the  row  coordinate  is 
multiplied  by  160  and  the  column  coordinate  by  two.  When  running  through  the 
string  to  be  printed,  the  memory  offset  is  incremented  by  two  on  each  pass, 
moving  it  one  ASCII/attribute  pair  to  the  right 

Pascal  listing:  DVIP.P 

^********************★************★***************★********************1 


* 

DVIP 

* 

* 

Task 

:  Demonstrates  direct 

access  to  video  RAM  frcxn 

* 

* 

* _ 

Turbo  Pascal 

* 

_ * 

* 

Author 

:  MICHAEL  TISCHER 

* 

* 

Developed  on 

:  10/02/1987 

* 

* 

Last  update 

:  06/20/1989 

* 

^  ************************* *********************************************  j 


program  DVIP; 


Uses  Crt,  Dos; 

{  Use  CRT  and  DOS  units 

const  NORMAL 

=  $07; 

{  Define  character  attributes  in 

LIGHT 

=  $0f; 

{  conjunction  with  monochrome 

INVERSE 

=  $70; 

{  video  card 

UNDERSCORED 

=  $01; 

BLINKING 

*  $80; 

BLACK 

=  $00; 

{  Color  attributes  for  color  card 

BLUE 

=  $01; 

GREEN 

=  $02; 

COBALTBLUE 

»  $03; 

RED 

=  $04; 

VIOLET 

=  $05; 

BROWN 

=  $06; 

LIGHTGRAY 

=  $07; 

DARKGRAY 

=  $01; 

LIGHTBLUE 

=  $09; 

LIGHTGREEN 

=  $0A; 

LIGHTCOBALT 

»  $0B; 

LIGHTRED 

»  $0C; 

LIGHTVIOLET 

=  $0D; 

YELLOW 

=  $0E; 

WHITE 

=  $0F; 

type  TextTyp  =  string [80]; 

var  VSeg  :  word;  {  Segment  address  of  video  RAM  } 
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^ **★★*★**★★★*★***★*★*★*★***★*★*★*★*★***★*★★★*★*★*★*★★★***★***★♦★*★*★*** j 

{*  InltDPrlnt:  Determines  segment  address  of  video  RAM  for  DPrlnt  *} 
{*  Input  ;  none 

{*  Output  :  none  *} 

^ ★★★★★★*★***★★★*★*★*★*★*★*★★★***★★★*★*★*★★★★★*★★★★★*★**★★★★*★★★***★***★} 

procedure  InltDPrlnt; 

var  CRTC_PORT  :  word  absolute  $0040:0063;  {  Variable  In  BIOS  var.seg.  } 


{  Monochrome  card  connected?  } 
{  YES,  video  RAM  at  8000:0000  } 
{  NO,  must  be  a  color  card  } 
{  Video  RAM  at  B800:0000  } 


^  **★★*******★***★*★*★*★***★*******★*★*★*★★★*★★★*★*★*★★★***★*★★★★★★★*★**  j 


{*  DPrlnt:  Writes  a  string  direct  into  video  RAM  *} 

{*  Input  :  -  COLUMN:  Output  column  *} 

{*  ,  -  LINES  :  Output  line  *) 

{*  -  COLOR  ;  Color  (attribute)  for  individual  characters  *} 

(*  “  STROUT:  String  to  be  displayed  *} 

Output  :  none  *} 


begin 

if  CRTC__PORT  -  $3B4  then 
VSeg  :-  $B000 
else 

VSeg  :-  $B800; 

end; 


procedure  DPrlnt (  Column,  Lines,  Color  :  byte;  StrOut  :  TextTyp) ; 

var  PAGE_OFS  :  word  absolute  $0040:$004E;  {  Variable  in  BIOS  var.seg.  } 
Offset  :  word;  {  Pointer  to  current  output  position  } 

i,  j  :  byte;  (  Loop  counter  } 

Attribute  :  word;  (  Attribute  for  output  } 

begin 

Offset  :«  Lines  *  160  +  Column  *  2  +  PAGE_OFS; 

Attribute  :*  Color  shl  8;  (  High  byte  for  word  access  to  video  RAM  } 

i  length (  StrOut  );  {  Determine  string  length  } 

for  j:«l  to  i  do  {  Execute  string  } 

begin  {  Put  character  &  attribute  directly  into  video  RAM  } 

memw [VSeg: Offset]  ;«=  Attribute  or  ord(  StrOut [j]  ); 

Offset  :-  Offset  +2;  {  Set  offset  to  next  ASCII/attribute  pair  } 

end; 

end; 


^  **********************************************************************  J 

{*  Demo;  Demonstrates  application  of  DPrlnt  *} 

{*  Input  :  none  *1 

{*  Output  :  none  *} 

I  ********************************************************************** J 


procedure  demo; 


var  Column,  {  Current  output  position  } 

Lines, 

Color  :  integer; 


begin 

TextBackGround (  BLACK  ) ; 
ClrScr; 

DPrint(  22,  0,  WHITE,  'DVIP 
Rand(xnize; 

while  not  KeyPressed  do 
begin 

Column  :*  Random (  76  ); 
Lines  :*  Random (  22  )  + 
Color  :»  Randan  (  14  )  + 
DPrlnt (  Column,  Lines, 


{  Turn  background  black  } 
{  Clear  screen  } 

-  (c)  1988  by  Michael  Tischer'); 

1  Enable  random  number  generator  } 
{  Repeat  until  user  presses  a  key  } 

{  Select  column,  row  and  } 
1;  {  color  at  random  } 

1; 

Color,  '[[[[');{  Block  character  can  be  } 
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DPrlnt(  Column,  Lines+1,  Color,  '[[[[');{  created  by  pressing  } 
end;  {<Alt><2><l><9>  } 

ClrScr;  {  Clear  screen  } 

end; 


{**  MAIN  PROGRAM  **} 

^ **********************************************************************  j 

begin 

InitDPrint; 

Demo; 
end. 

The  BASIC  implementation 

This  version  doesn't  really  fulfill  its  goal,  since  it  is  slower  than  the  already  slow 
PRINT  command.  But  we  have  included  it  for  the  sake  of  completeness,  and 
because  it  is  a  good  example  of  how  you  can  access  the  entire  address  space  of  the 
8088  from  within  BASIC. 


{  Initialize  output  using  DPrint  } 
{  D«nonstrate  DPrint  } 


The  commands  DEF  SEG,  PEEK,  and  POKE  are  the  heart  of  memory  access  in 
BASIC.  DEF  SEG  sets  the  segment  address  of  the  "current"  64K  segment.  PEEK 
and  POKE  can  then  be  used  to  read  and  write  bytes  from  or  to  this  segment.  This 
technique  is  used  in  the  initialization  routine  at  line  number  50000,  which  first 
defines  the  BIOS  variable  segment  as  the  current  segment  From  there  two  PEEK 
commands  read  the  port  address  of  the  CRTC  address  register  and  the  variable  VR 
is  loaded  with  the  segment  address  of  the  video  RAM. 


This  address  is  used  in  the  output  routine  at  line  number  51000  in  combination 
with  the  DEF  SEG  command,  which  defines  the  video  RAM  as  the  current 
segment  But  first  we  calculate  the  offset  address  in  the  video  RAM  by  reading  the 
start  address  of  the  current  screen  page  from  the  BIOS  variable  area  and  then  adding 
the  offset  address  of  the  output  position  within  the  video  RAM.  As  in  the  Pascal 
version,  this  is  calculated  by  adding  the  product  of  the  row  coordinate  (variable 
CLINE%)  by  160  and  the  column  coordinate  (COLUMN%)  by  2. 

BASIC  listing:  DVIB.B 


100 

110 

120 

130 

150 

160 

170 

180 

190 

200 

210 

220 

230 

240 

250 

260 

270 

280 

290 

300 


***ii*******-k-tfk*-k-t,-k-k1i*ic-k-tfk****-k**************1r******-k*ifk-k*-kifk*****iHr 

•*  D  V  I  B  * 


'*  Task  :  Demonstrates  direct  access  to  video  RAM  * 
•*  Author  :  MICHAEL  TISCHER  * 
•*  Developed  on  :  10/01/1988  * 
'*  Last  update  ;  06/21/1989  * 

I****************************************************************** 


CLS  :  KEY  OFF 

GOSUB  50000  'Determine  segment  address  of  video  RAM 

COLUMN%=22  :  CLINE%=0  :  COL%  =  15 

T$  =  "DIVB  -  (c)  1988  by  MICHAEL  TISCHER"  :  GOSUB  51000 
FCOL%  =  0  :  T$  =  "[[[["  'Define  string  and  starting  color 

A$  =  INKEYS  :  IF  A$<>""  THEN  400  'Repeat  until  user  presses  a  key 
FCOL%  =  FCOL%  +  1  'Increment  starting  color 

IF  FCOL%  >  15  THEN  FCOL%  =  1  'When  FCOL%=16  make  FCOL%=l 

COL%  =  FCOL%  'Set  color  for  first  square 

FOR  COLUMN%=0  TO  76  STEP  4  'Execute  for  each  column 

FOR  Z%*1  TO  24  STEP  2  'Execute  for  each  line 
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310  CLINE%  -  Z% 

320  CLINE%  -  Z%+1 

330  COL%  -  COL%  + 

340  NEXT 

350  NEXT 

360  GOTO  250 

370  • 

400  CLS 
410  END 
460  • 


GOSUB  51000 
:  GOSUB  51000 
1  AND  15 


'Display  first  line  of  square 
'Display  second  line 
'Set  next  color 


'Clear  screen 


I  ********************************************************* ******* • 


50000 

50010  '*  Determine  segment  address  of  video  RAM 


50020 

50030 

50040 

50050 

50060 

50070 

50080 

50090 

50100 

50120 

51000 

51010 

51020 

51030 

51040 

51050 

51060 

51070 

51080 

51090 

51100 

51110 

51120 

51130 

51140 

51150 

51160 

51170 

51180 

51190 

51200 


'*  Input  :  none  *' 

'*  Output  :  VR  is  the  segment  address  of  video  RAM  *' 

•  **************************************************************** • 

DEF  SEG  «  &H40  'Segment  address  of  BIOS  variable  range 

VR  -  PEEK(4H63>  +  PEEK(iH64)  *  256  'Get  CRTC  port 

IF  VR  -  4H3B4  THEN  VR  «  4HB000  ELSE  VR  -  4HB800 

RETURN  'Back  to  caller 

•  ****************************************************************  I 

'*  Write  string  direct  into  video  RAM  *' 

I  * _ _ _ _ _ *  • 

'*  Input  :  -  COIjUMN%  *  the  output  column  ** 

'*  -  CLINE%  =  the  output  line  *' 

'*  -  COIi%  *  string  color  *' 

'*  -  T$  -  the  string  to  be  displayed  *' 

'*  Output  :  none  *' 

I  **************************************************************** • 

DEF  SEG  -  fiH40  ' Segment  address  of  BIOS  variable  range 

OF%  -  PEEK(&H4E>  +  PEEK(&H4F)  *  256  'Starting  address  of  page 

OF%  «  OF%  +  COLUMN%  *  2  +  CLINE%  *  160  'Offset  of  first  character 
DEF  SEG  -  VR  'Set  segment  address  of  video  RAM 

FOR  I%-1  TO  LEN(T$)  'Execute  string 

POKE  OF%,  ASC(MID$(T$,I%,1)>  'ASCII  code  in  video  RAM 

POKE  OF%+l,  COL%  'Color  in  video  RAM 

OF%  =  OF%  +  2  'Set  offset  to  next  character 

NEXT 

RETURN  'Back  to  caller 
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the  AT  Reaitime  Ciock 


The  AT  has  a  battoy  op^ted  realtime  clock  on  the  main  circuit  board.  The  clock 
is  part  of  the  Motorola  MC-146818  processor.  This  processor  also  contains  64 
bytes  of  battery  backup  RAM.  This  RAM  accepts  clock  data  and  system 
configuration  data.  It  can  be  accessed  through  port  addresses  70H  to  7FH. 
However,  only  ports  70H  and  71H  are  of  interest  to  the  user. 

Realtime  clock  registers 

As  the  following  table  shows,  the  clock  has  thirteen  memory  registers  of  interest: 


0 

Current  second 

1 

Alarm  second 

2 

Current  minute 

3 

Alarm  minute 

4 

Current  hour 

5 

Alarm  hour 

6 

Day  of  the  week 

7 

Number  of  day 

8 

Month 

9 

Year 

10 

Clock  status  register  A 

11 

Clock  status  register  B 

12 

Clock  status  register  C 

13 

Clock  status  register  D 

Every  time  field  (second,  minute,  hour)  has  a  similar  alarm  field.  These  alarm 
fields  allow  the  programmer  to  set  the  clock  to  trigger  an  interrupt  at  a  particular 
time  of  the  current  day  (more  on  this  later). 


563 


11.  Accessing  and  Programming  the  AT  Reedtime  Clock 


PC  System  Programming 


Weekday 

The  day  of  the  week  provides  the  number  of  the  current  weekday:  The  value  1 
represents  Sunday,  the  value  2  stands  for  Monday,  3  for  Tuesday,  etc. 


Year 


The  year  is  counted  relative  to  the  century  (the  system  assumes  1900).  The  value 
87  in  this  field  represents  the  year  1987. 

The  four  status  registers  allow  user  programming  of  the  clock. 


Status  register  A  of  the  clock 

The  ROM-BIOS  set  the  two  lower  fields  of  these  registers  during  the  system  boot 
The  interrupt  frequency  field  has  a  default  value  of  01 10(b).  This  value  results  in 
an  interrupt  frequency  of  1024  interrupts  per  second  (an  int^rupt  ev^y  976,562 
microseconds). 

The  contents  of  the  time  frequency  field  is  010(b).  This  field  triggers  a  time 
frequency  of  32,768  kiloHertz. 

Bit  7  of  the  status  register  is  of  interest  to  the  programmer  in  conjunction  with 
these  two  fields.  It  indicates  wheth^  a  second  has  just  els^sed,  and  increments  the 
time  fields  (seconds,  minutes,  hour).  If  a  second  hasn't  closed,  this  bit  contains  a 
1.  This  bit  is  interesting  because  you  can  only  read  the  individual  time  fields  when 
the  time  is  not  being  updated.  Otherwise  a  minute  could  pass  and  the  second 
counter  reset  to  0  before  the  minute  counter  could  be  incremented.  This  could  cause 
a  time  jump  from  13:59:59  to  13:59:00,  then  the  correct  display  of  14:00:01  one 
second  later. 

Accessing  status  register  A 

Since  status  register  A  is  a  part  of  the  64-byte  RAM,  you  can  access  it  like  any 
other  memory  location.  First  you  load  the  number  of  the  memory  location  to  be 
accessed  into  the  AL  register  (in  this  case,  the  value  10).  Then  you  pass  this  value 
to  port  70H  using  the  OUT  instruction.  The  chip  recognizes  that  an  access  to  one 
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of  its  memory  locations  occurred.  Either  an  OUT  instruction  then  writes  to  port 
71H  or  an  IN  instruction  reads  the  memory  contents  firom  fort  71H. 

The  following  instructions  read  or  write  a  memcMy  location  in  the  realtime  clock: 


WRITE: 

mov  al,Memory_location 
out  70h,al 
mov  al,New__contents 
out  71h,al 

Status  register  B 


READ: 

mov  al,Memory_location 
out  70h,al 
in  al,71h 


Some  clock  settings  can  be  programmed  through  status  register  B.  Bit  0  of  status 
register  B  controls  daylight  savings  time  status.  When  this  bit  is  set  to  1,  it 
indicates  that  daylight  savings  time  is  in  effect  A  value  of  0  (the  default  value  for 
this  bit)  shows  that  standard  time  is  in  effect. 


Bit  1  decides  whether  the  clock  should  opiate  in  12-hour  or  24-hour  mode.  In  12- 
hour  mode  it  switches  after  every  12  hours  (midnight  and  noon)  to  1  o'clock  again. 
The  24-hour  mode  switches  to  1  o'clock  after  24  hours.  24-hour  mode  is  active 
when  you  boot  the  system. 


Clock  status  register  B 
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Bit  2  defines  the  format  in  which  the  time  and  dale  fields  are  stored.  If  this  bit 
contains  a  1,  the  various  dates  are  stored  in  binary  notation.  The  year  (19)87  is 
coded  as  01010111(b)  in  BCD  fc»mat,  which  is  switched  on  by  the  value  0  in  bit 
2.  Two  numbers  are  stored  in  every  byte.  The  higher  half  is  stored  in  the  most 
significant  four  bits  and  the  lower  h^f  in  the  least  significant  four  bits. 


Binary 


27  2®  2^  2^  2^  2^  2^  2° 


0  10  1  0  111 


0  +64+  0  +16  +  0  +  4  +  2  +  1 


Bit  value 


87 


BCD 


23  22  2^  2° 


2^  2^  2^  2^ 


Bit  value 


The  number  87  in  binary  and  in  BCD  (Binary  Coded  Decimal)  format 

Nonnally  this  bit  contains  a  0  and  the  numbers  are  stored  in  BCD  format 

Note:  BIOS  assumes  BCD  representation  when  performing  the  date 

function  with  interrupt  1  AH.  Application  programs  which  call  these 
functions  and  obtain  the  information  in  binary  format  instead  of  the 
expected  BCD  may  crash.  The  same  applies  to  the  12-hour/24-hour 
time  measurement,  although  a  change  to  the  12-hour  cycle  wouldn’t 
result  in  as  serious  consequences  as  the  change  in  the  date. 

Bit  4  determines  whether  an  interrupt  should  be  called  after  the  time  (and  date) 
update.  This  bit  must  contain  a  1  if  an  interrupt  should  be  called.  The  system 
suppresses  this  interrupt  by  setting  this  bit  to  0  during  the  booting  process. 

Bit  5  can  trigger  an  alarm.  The  clock  reads  the  alarm  time  from  locations  1, 3  and 
S  (seconds,  minutes  and  hours)  of  clock  RAM.  When  the  alarm  time  is  reached,  an 
interrupt  executes  when  bit  5  is  set  to  1.  The  system  suppresses  this  interrupt 
when  it  sets  bit  5  to  0  during  the  booting  process. 

Bit  6  controls  periodic  interrupt  calls  when  it  is  set  to  1.  The  frequency  of  the 
interrupt  calls  depends  on  the  interrupt  frequency  coded  into  bits  0-3  of  status 
register  A.  Since  the  default  value  on  bootup  is  a  fi^uency  of  1,024  kiloHertz,  the 
interrupt  triggers  every  967,562  microseconds.  Since  bit  6  is  set  to  0  at  the  system 
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start,  an  application  program  must  set  it  to  1  beftve  periodic  interrupt  calls  can 
execute. 

Bit  7  controls  the  periodic  updating  of  the  time  and  date,  once  every  second.  This 
bit  is  set  to  0  when  you  boot  the  system  so  that  the  time  constantly  increments. 
Before  entering  a  new  date  and  time  in  the  various  memory  locations,  this  bit 
should  be  Brst  set  to  1  to  prevent  the  clock  from  changing  the  time  immediately. 
Once  you  have  entoed  all  the  <tata  necessary,  this  bit  can  be  reset  and  the  time  can 
continue  updating. 

Calling  the  correct  interrupt 

We've  used  the  phrase  "calling  the  intrarupt"  many  times  in  this  section,  without 
really  telling  you  which  interrupt  should  be  called.  Even  though  there  are  sevoal 
reasons  for  the  clock  to  call  an  intorupt  (alarm  time,  periodic  interrupts,  etc.), 
interrupt  70H  is  the  interrupt  consistendy  called.  This  intmupt  contains  a  BIOS 
routine  which  controls  the  two  time  functions  in  interrupt  13H,  among  other 
things. 

The  routine  uses  status  register  C  of  the  clock  to  determine  the  reason  for  the  call. 
Only  bits  4, 5  and  6  of  this  register  are  of  interest  to  us  here.  They  cturespond  to 
the  bits  in  status  register  B.  For  example,  when  you  trigger  the  alarm  interrupt 
(which  can  only  occur  if  bit  S  in  status  register  B  was  set)  then  bit  S  in  status 
register  C  is  also  set  to  indicate  that  the  alarm  time  has  been  reached. 


7  654  321  Obit 


Status  register  C 

The  Erst  task  of  the  routine  which  intm:epts  interrupt  70H  is  to  read  status  register 
C.  The  routine  then  determines  the  reason  for  the  interrupt  call  and  reacts 
accrxdingly. 
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Status  register  D 

Status  register  D  only  has  one  bit  of  interest:  bit  7.  It  indicates  the  status  of  the 
battery  which  maintains  the  storage  of  data,  even  when  the  PC*s  power  supply  is 
turned  off.  If  this  bit  has  the  value  0,  you  should  replace  the  battery  because  the 
present  battery  is  dead  or  near  death. 


Some  configuration  information  follows  status  register  D. 


Byte 

14 

Diagnostic  byte  ' 

15 

Status  on  termination  of  the  system  ^ 

16 

Disk  description 

17 

reserved 

18 

Hard  Disk  description 

19 

reserved 

20 

Configuration 

21 

Low  byte  of  the  main  memory  in  kilobytes 

22 

High  byte  of  the  main  memory  in  kilobytes 

23 

Low  byte  of  the  additional  memory  in  kilobytes 

24 

High  byte  of  the  additional  memory  in  kilobytes 

25-45 

reserved 

46 

High  byte  of  the  checksum  for  memory  locations  16-32 

47 

Low  byte  of  the  checksum  for  memory  locations  16-32 

48 

Low  byte  of  the  additional  memory  in  kilobytes 

49 

High  byte  of  the  additional  memory  in  kilobytes 

50 

the  first  two  numbers  of  the  century  as  BCD  number 

51 

Boot  information 

52-63 

reserved 

Diagnostic  byte  (address  14) 


[Mt _ 

Meaning 

O 

1 

ro 

reserved 

3 

0  =  Hard  disk  and  controller  o.k. 

1  =  Hard  disk  not  present  or  not  functional 

4 

0  =  Memory  size  in  memory  locations  21-24 

1  =  other  memory  size  determined  during  booting 

5 

0  =  Configuration  in  memory  location  20  o.k. 

1  =  another  configuration  found  during  booting 

6 

0  =  Checksum  in  memory  location  46  and  47  o.k. 

1  =  Checksum  in  memory  location  46  and  47  is  false 

7 

0  =  Battery  is  o.k. 

1  =  Battery  dead  or  almost  dead 
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Disk  description  (address  16) 


bit 

meaning 

0-3 

Type  of  second  installed  drive  (DOS  designation:  B) 

0000(b)  =  no  second  disk  drive 

0001(b)  -  320/360K  drive 

0010(b)  =  1.2  megabyte  drive 

4-7 

Type  of  first  installed  drive  (DOS  designation:  A) 

0000(b)  =  no  disk  drive 

0001(b)  =  320/360K  drive 

Note:  If  you  program  the  clock  for  generating  time-dependent  interrupts, 

and  you  point  interrupt  vector  70H  to  a  user  routine,  remember  that 
if  the  user  routine's  end  doesn't  return  to  die  BIOS,  you  must  send  an 
EOI  instruction  to  the  ATs  two  interrupt  controllers,  since  interrupt 
70H  is  a  hardware  interrupt  triggoed  by  one  of  these  conttollo^. 

Demonstration  programs 

The  three  programs  listed  below  show  how  you  can  access  the  realtime  clock  from 
BASIC,  Pascal  or  C.  Three  routines  in  particular  perform  most  of  the  functions. 
The  first  routine  reads  a  value  from  one  of  the  clock's  memory  locations.  The 
second  routine  places  a  value  there.  The  third  routine  checks  whether  the  clock  is 
operating  in  binary  mode  or  BCD  mode,  then  reads  a  memory  location  in  the 
clock,  converting  die  contents  of  this  location  from  BCD  into  binary  if  necessary. 
This  routine  is  important  for  access  to  all  memory  locations  containing 
information  on  date  and  time  which  could  be  coded  in  BCD  or  in  binary  format 

The  main  program  checks  the  battery  on  the  clock.  If  there's  power  in  the  battoy, 
the  program  calls  two  routines  which  read  the  contents  of  the  memory  locations 
for  the  current  date  and  current  time  from  the  clock,  among  other  things.  This  data 
i^ipears  on  the  screen. 


The  main  program  doesn't  access  the  routine  for  description  of  memory  locations. 
It  should  be  easy  to  convert  the  program  so  that  the  routine  for  the  description  of 
memory  locations  writes  to  the  clock  instead  of  reading  date  and  time.  This  is  just 
a  suggestion;  feel  free  to  experiment 


BASIC  listing:  RTC.BAS 


**********************  **********11  ******  ******** 
*  R  T  C 


* _ 

*  Task 


100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 

210  CLS  'Clear  Screen 

230  PRINT- RTC  (c)  1987  by  Michael  Tischer-  ;  PRINT 


_ _ _ *  • 


;  makes  two  Subroutines  available 

*  for  reading  and  writing  data 

*  from  the  RTC  of  the  AT 

*  Author  :  MICHAEL  TISCHER 

*  developed  on  :  7.24.87 

*  last  Update  ;  9.21.87 

***********************************  Iti, -kic*  *i,  I,  ***-k-k*  ******  ******* 
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240  PRINT" Information  from  the  battery  buffered  real  time  clock  " 

260  PRINT 

270  ADR%  -  14  :  GOSUB  50000  'read  diagnostic-byte  from  the  RTC 

280  IF  (C0N%  AND  128)  -  0  THEN  310  'bit  8  -  1  ~>  battery  o.k. 

290  PRINT"  WARNING!  The  battery  of  the  clock  is  low!" 

300  END 

310  ADR%  -  11  :  GOSUB  50000  'read  status-register  B  of  the  RTC 

320  PRINT"-  the  clock  is  operated  in  (C0N%  AND  2)  *  6  +  12; "hour-mode  " 
330  PRINT"-  the  time:  "; 

340  ADR%  -  4  :  GOSUB  52000  'read  the  hour  and  convert  to  decimal 

350  PRINT  USING  "##:";C0N%; 

360  ADR%  -  2  :  GOSUB  52000  'read  the  minutes  and  convert  to  decimal 

370  PRINT  USING  "##:";C0N%; 

380  ADR%  -  0  :  GOSUB  52000  'read  the  seconds  and  convert  to  decimal 

390  PRINT  USING  "##";C0N% 

400  PRINT"-  the  date:  "; 

410  ADR%  -  6  :  GOSUB  52000  'read  day  of  week  and  convert  to  decimal 

420  RESTORE  540 

430  FOR  1%  -  1  TO  CON%  :  READ  DAYS  :  NEXT  'read  name  of  the  day 

440  PRINT  DAYS;",  the  "; 

450  ADR%  »  7  :  GOSUB  52000  'read  day  of  month  and  convert  to  decimal 

460  PRINT  USING  "##.";CQN%; 

470  ADR%  »  8  :  GOSUB  52000  'read  month  and  convert  to  decimal 

480  PRINT  USING  "##.";CQN%; 

490  ADR%  -  9  :  GOSUB  52000  'read  year  and  convert  to  decimal 

500  PRINT  USING  "####" ;CON%+1900 

510  PRINT 

520  END 

530  ' 

540  DATA  "Sunday", "Monday", "Tuesday", "Wednesday" 

550  DATA  "Thursday", "Friday", "Saturday" 

560  ' 

50000 
50010 
50020 
50030 
50040 
50050 
50060 
50070 
50080 
50090 
50100 
51000 
51010 
51020 
51030 
51040 
51050 
51060 
51070 
51080 
51090 
51100 
51110 
52000 
52010 
52020 
52030 
52040 
52050 
52060 
52070 
52080 
52090 
52100 
52110 
52120 
52130 


*****  ******  *******■/,***  ************************  **********  * 

'*  read  the  content  of  a  memory  location  of  the  RTC  *' 


'*  Input:  ADR%  »  the  number  of  the  memory  location  (0  to  63)  *' 

'*  Output:  CON%  =  the  content  of  this  storage  location  *' 

***************************************************************** 

OUT  &H70,ADR%  'number  of  memory  location  to  RTC-address-register 
CC»^%  «  INP(4H71)  'read  Content  fron  RTC-data-register 

RETURN  'back  to  caller 

I  ***************************************************************  I 

'*  write  a  memory  location  in  the  RTC  *' 


'*  Input:  ADR%  “  the  number  of  the  memory  location  (0  to  63)  *' 

**  CC»I%  =  the  new  content  of  this  memory  location  *' 

'*  Output:  none  *' 

***************************************************************** 

• 

OUT  &H70,ADR%  'number  of  monory  location  to  RTC-address-register 
OUT  4H71,CC»I%  'write  new  content  into  RTC-data-register 
RETURN  'back  to  the  caller 

•***************************************************************i 

'*  read  the  content  of  a  date  or  time  memory  location  *' 

'*  frcMi  the  RTC  and  convert  to  decimal  *' 

•  * _ : _ *  * 

'*  Input  :  ADR%  =  the  number  of  the  memory  location  (0  to  63)  *' 

'*  Output:  CON%  =  the  new  content  of  this  memory  location  ** 

'*  Info  :  ADR%  is  changed  this  subroutine  *' 

***************************************************************** 


GOSUB  50000  'read  content  of  the  memory  location 

BCD%  =  CON%  'record  content  of  the  memory  location 

ADR%  «  11  'Address  of  the  Status  registers  B  of  the  RTC 

GOSUB  50000  'read  its  content 

IF  (CON%  AND  2)  =  0  THEN  52150  'test  if  BCD-mode 
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52140  BCD%  -  (BCD%  AND  15)  +  INT (BCD%  /  16)  *  10  'convert  BCD  to  decimal 
52150  CON%  “  BCD%  'set  return  value 

52160  RETURN  'back  to  caller 


Pascal  listing:  RTC.PAS 

^ ★*★★★**★★**★★★★*★*★*★*★*★★★*★★★*★★★*★★**★★*★★★*★*********** **********} 


{*  R  T  C  *} 

- *} 

{*  Task  :  makes  two  Functions  available  for  reading  and  *} 

{*  writing  data  in  the  RTC  *} 

- *) 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  developed  on  :  7.10.87  *) 

{*  last  Update  :  9.21.87  *} 


^  *★*★★★★★★★★★★★★★★*★★★*★★★*★★★*★*★★★*★*★*★*★*★★★*★*★*★*★*★★★**********} 
program  RTCP; 


{Turbo  4.0 

only) 

RTCAdrPort 

_ 

$70; 

{  Address-Register  of  the 

RTC  } 

RTCDtaPort 

= 

$71; 

{  Data-Register  of  the 

RTC  ) 

SECONDS 

0; 

{  Addresses  of  some  manory  locations  of 

RTC  } 

MINUTE 

2; 

HOUR 

= 

4; 

DAYOFWEEK 

6; 

DAY 

7; 

MONTH 

* 

8; 

YEAR 

= 

9; 

STATUSA 

= 

10; 

STATUSB 

= 

11; 

STATUSC 

12; 

STATUSD 

= 

13; 

DIAGNOSIS 

= 

14; 

YEARHUNDRED 

= 

50; 

^  *★***★*★*★**★**★★******★*★**★***★*★*★*★*★***★************★★*★★**★*★★* } 


{*  RTCREAD:  reads  the  content  of  a  memory  location  of  the  RTC  *} 
{*  Input  :  the  address  of  the  memory  location  in  the  RTC  *} 
{*  Output  :  the  content  of  this  memory  location 

{*  Info  :  if  the  Address  is  outside  the  permitted  area  *} 
(*  (0  to  63),  the  value  -1  is  returned  *} 


^******★*******★****★****★★★*★★★*★*★★★*★*★*★*★*★★**★★★*★★★*★*★★★★★*★★★1 
function  RTCRead (Address  :  integer)  :  integer; 
begin 

if  (Address  <  0)  or  (Address  >  63) 
then  RTCRead  :=  -1 
else 
begin 

port [RTCAdrPort ]  :=  Address; 

RTCRead  :*  port [RTCDtaPort] 
end 
end; 


{*  RTCDT  :  read  a  memory  location  for  date  or  time  from  the  *} 
{*  RTC  and  convert  the  result  into  a  binary  value 

if  the  RTC  works  in  BCD-Format  *} 
{*  Input  :  the  address  of  the  memory  location  in  the  RTC  *} 
{*  Output  :  the  content  of  this  memory  location  as  binary  value  *} 
{*  Info  :  if  the  address  is  outside  the  permitted  area  (0  -  63)  *} 
{*  the  value  -1  is  returned  *} 


{  is  the  Address  o.k.?  } 
{  NO!  ) 


{  transmit  Address  to  the  RTC  } 
{  read  its  Content  } 


571 


IL  Accessing  and  Programming  the  AT  Realtime  Clock 


PC  System  Programming 


{★★★*★**★************************************«***************** *******j 

function  RTCDT (Address  :  integer)  :  integer; 

var  Value  :  integer;  {  for  memory  of  a  value  which  was  read  } 

begin 

if  (RTCRead (STATUSB)  and  2=0)  {  BCD-  or  Binary-Mode?  } 

then  RTCDT  :=  RTCRead (Address)  {  is  Binary-Mode  } 

else  {  is  BCD-Mode  } 

begin 

Value  ;*  RTCRead (Address) ;  {  get  Content  of  the  memory  location  } 

RTCDT  :=  (Value  shr  4)  *  10  +  Value  and  15 {  convert  BCD  to  binary  } 
end 
end; 


{*★★*★★*★★** A********************* ***************** **★★**★***★*★★*★★★★ ^ 

{*  RTCWRITE:  write  a  value  into  one  of  the  memory  locations  of  RTC  *} 
{*  Input  :  see  below  *} 

{*  Output  :  none  *} 

{*  Info  :  the  address  can  be  between  0  to  63  *} 

I  ********************************************************************* j 

procedure  RTCWrite (Address  :  Integer;  {  the  address  of  the  location  } 
Content  :  byte);  {  the  new  content  } 

begin 

port [RTCAdrPort]  :=  Address;  {  transmit  address  to  the  RTC  } 

port [RTCDtaPort ]  :=  Content  {  write  new  value  } 

end; 

^ ******************************************************* **************} 
{*  MAIN  PROGRAM  *} 

^ *********************************************************** **********} 


begin 

clrscr;  {  Clear  Screen  } 

writelnCRTC  (c)  1987  by  Michael  Tischer'#13#10); 
writelnC Information  from  the  real  time  clock  '); 

writeln  ( '  ==-==»===*=====»===*==*==»===»»«=»*===*»=-»==»==»=—» '  #13#10) ; 
if  RTCRead (Diagnosis)  and  128  =  0  then  {  is  the  Battery  o.k.?  } 

begin  {  the  Battery  is  o.k.  } 

writeln ( '-the  clock  is  being  operated  in  (RTCRead (STATUSB)  and  2) *6+12, 
'  hour-mode ' ) ; 

writeln ( • -  the  time:  ' ,  RTCDT (HOUR) ,  ' : ' ,  RTCDT (MINUTE) : 2, 

• : • ,  RTCDT (SECONDS ) : 2 ) ; 
write ('-  the  date:  '); 

case  RTCDT (DAYOFWEEK)  of  {  Read  Day  of  the  Week  } 

1  :  write (' Sunday* ) ; 

2  :  write ( 'Monday* ) ; 

3  :  write ( 'Tuesday' ) ; 

4  :  write ( ' Wednesday ' ) ; 

5  :  write ( 'Thursday') ; 

6  :  write ( ' Friday ' ) ; 

7  :  write ('Saturday') 
end; 

writelnC,  the  ',  RTCDT  (DAY) ,  RTCDT  (MONTH) ,  '.', 

RTCDT (YEARHUNDRED) ,  RTCDT (YEAR) ) ; 

end 

else  {  the  Battery  of  the  RTC  is  exhausted!  } 

write  ('  WARNING!  The  Battery  of  the  clock  is  low!') 

end. 
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C  listing:  RTC.C 

/***★★ ****************************************************** **********/ 


/*  R  T  C  */ 

/★ _ I - - - */ 

/*  Task  :  provides  two  Functions  for  reading  and  writing  */ 

/*  Data  in  the  Real  Time  clock  */ 

/* - - - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  developed  on  :  8.15.87  */ 

/*  last  Update  :  9.21.87  */ 

/* - V 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  MSC  RTCC;  */ 

/*  LINK  RTCC;  */ 

/*  Call  :  RTCC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  Through  the  RUN  command  in  the  ccanmand  line  */ 


/*★************* ********************************************** ********/ 


e  <dos.h> 
e  <conio.h> 

byte  unsigned  char 

RTCAdrPort 

0x70 

RTCDtaPort 

0x71 

SECONDS 

0  /* 

MINUTE 

2 

HOUR 

4 

DAYOFWEEK 

6 

DAY 

7 

MONTH 

8 

YEAR 

9 

STATUSA 

10 

STATUSB 

11 

STATUSC 

12 

STATUSD 

13 

DIAGNOSE 

14 

YEARHUNDRED 

50 

/*  Include  header-files  */ 


/*  address-register  of  the  RTC  */ 
/*  data-register  of  the  RTC  */ 

*  addresses  of  some  memory  locations  of  RTC  */ 


/★★★*★★**★*★**★★*★★★★★★★★*★*★★★★*★*★*★★★★**★★★*★★★★********★***★***★★*/ 
/*  RTCREAD:  reads  the  content  of  a  memory  location  of  the  RTC  */ 

/*  Input  :  the  address  of  the  memory  location  in  the  RTC  */ 

/*  Output  :  the  Content  of  this  memory  location  */ 

/★★★★★★*****★**★*********★★★**★***★★***★**★★★*★*★★*★**★*★★★***★★★**•***/ 


byte  RTCRead (Address) 

byte  Address;  /*  the  memory  location  of  the  RTC  */ 

( 

outp(RTCAdrPort,  Address);  /*  transmit  address  to  the  RTC  */ 

return (inp(RTCDtaPort) ) ;  /*  read  content  and  transmit  to  caller  */ 

} 

/★**★*****★*★*★*****★*★**★***★****★******★**********★***★*********★**★/ 


/*  RTCDT  :  reads  date  or  time  from  one  of  the  memory  locations  */ 
/*  and  converts  the  result  into  a  Binary  value  */ 
/*  if  the  clock  works  in  BCD-Fomat  */ 
/*  Input  :  the  address  of  the  memory  location  in  the  RTC  */ 
/*  Output  :  the  content  of  this  memory  location  as  Binary  Value  */ 
/*  Info  :if  the  address  is  outside  the  permitted  area  */ 
/*  (0  to  63)  the  Value  -1  is  returned  */ 


/★****★***★**★★* ****** ************** **********************************/ 
byte  RTCDt (Address) 

byte  Address;  /*  the  memory  location  in  the  RTC  */ 
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if  (RTCRead (STATUSB)  &  2)  /*  BCD-  or  binary  mode?  */ 

return ( (RTCRead (Address)  »  4)  *  10  +  (RTCRead (Address)  &  15)); 
else  return (RTCRead (Address) ) ;  /*  is  binary  mode  */ 

} 

/*********************************************************************/ 
/*  RTCWRITE:  write  a  value  into  one  of  the  memory  locations  of  RTC  */ 
/*  Input  :  see  below  */ 

/*  Output  :  none  */ 

/*  Info  :  the  address  must  be  between  0  to  63  */ 

/******  ifk********-k**-k-lfk-k-k-k-k*-k**-k-k**-k***-k  *************-11*********  *******/ 

void  RTCWr it e (Address,  Content) 

byte  Address;  /*  address  of  the  memory  location  */ 

{ 

outp(RTCAdrPort,  Address);  /*  transmit  address  to  the  RTC  */ 

putp(RTCDtaPort,  Content);  /*  write  new  value  */ 

} 


/************************  *************** -kit*****  ******************  *****/ 

/**  MAIN  PROGRAM  **/ 

/*************************ifk  ******************************** **********/ 

void  mainO 
{ 

static  char  *Weekdays[]  *  /*  Names  of  the  weekdays  */ 

{ 

"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday",  "Saturday" 
Im¬ 
print  f  ("\nRTC  (c)  1987  by  Michael  Tischer\n\n") ; 
print f ("Information  from  the  real  time  clockXn"); 

print f  (•*===«==============================================\n\n") ; 

if  (! (RTCRead (DIAGNOSE)  &  128))  /*  is  the  Battery  o.k.?  */ 

{  /*  the  Battery  is  o.k.  */ 

printf("-  The  clock  is  operated  in  %d  hour  mode  \n", 

(RTCRead (STATUSB)  &  2) *6+12); 
prlntf("-  the  time:  %2d:%2d:%2d\n", 

RTCDt (HOUR) ,  RTCDt (MINUTE) ,  RTCDt (SECONDS) ) ; 
printfC'-  the  date:  "); 

printf("%s,  der  %d.%d.%d%d\n".  Weekdays [RTCDt (DAYOFWEEK) -1] , 

RTCDt (DAY) ,  RTCDt (MONTH) ,  RTCDt (YEARHUNDRED) ,  RTCDt (YEAR) ) ; 


} 

else  printf("  WARNING!  The  battery  of  the  clock  is  low!\n"); 

} 
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The  keyboard  is  an  independent  unit  in  the  PC  system,  and  has  its  own 
microprocessor  and  memory.  The  processor  informs  the  system  when  a  key  is 
pressed  or  released.  It  does  this  by  sending  the  system  something  called  a  scan  code 
when  a  key  is  pressed  or  released.  In  both  cases  the  key  is  indicated  by  a  code 
which  depends  on  the  position  of  the  key.  These  scan  codes  have  nothing  to  do 
with  the  ASCII  or  extended  keyboard  codes  to  which  the  system  later  converts  the 
keypresses. 

Communication  with  the  system  is  performed  over  two  bidirectional  lines  using  a 
synchronous  serial  communications  protocol.  In  addition  to  the  actual  data  line 
used  to  transfer  the  individual  bits,  the  clock  line  synchronizes  the  periodic 
transmission  of  signals.  Transfers  are  made  in  one-byte  increments,  whereby  a  stop 
bit  is  transmitted  first  (with  the  value  0),  followed  by  the  eight  data  bits, 
beginning  with  the  least  significant  bit.  A  parity  bit,  calculated  using  odd  parity, 
follows  the  eighth  data  bit.  The  transfer  of  a  byte  then  concludes  with  a  stop  bit, 
which  forms  the  eleventh  bit  of  the  transfer.  At  both  ends  of  the  communications 
line  (i.e.,  in  the  PC  and  in  the  keyboard  itselO  are  devices  which  convert  the 
signals  on  the  data  line  to  bytes  and  back  again. 

Although  all  types  of  PCs  use  this  form  of  communication,  we  must  distinguish 
between  PC/XT  and  AT  models.  These  systems  use  different  processors  as 
keyboard  controllers.  The  Intel  8048  used  in  the  keyboards  of  PCs  and  XTs  is  a 
relatively  "dumb”  device,  which  can  only  send  the  scan  codes  to  the  system. 
However,  the  8042  processor  used  in  AT  and  80386  keyboards  can  do  much  more. 
Here  the  communication  between  the  system  and  the  keyboard  becomes  relatively 
complex,  and  the  system  can  even  control  parts  of  the  keyboard. 

The  heart  of  this  communication  at  the  keyboard  end  is  represented  by  a  status 
register  and  input  and  output  buffers.  The  buffers  transfer: 


Keyboard  codes  which  correspond  to  pressing  or  releasing  a  key 
Data  which  the  system  requests  from  the  keyboard 
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TTiese  buffos  can  be  accessed  at  port  60H  on  the  AT. 

The  input  buffer  can  be  written  at  port  60H  as  well  as  pwt  64H.  TTie  port  which  is 
used  depends  on  the  type  of  infcnmation  to  be  transfmed.  If  the  systm  wants  to 
send  a  command  code  to  the  keyboard,  it  must  be  sent  to  port  ^H,  while  the 
corresptHiding  data  byte  is  sent  to  port  64H.  Both  end  up  in  the  keyboard  input 
buffer,  but  a  flag  in  the  status  registo*  indicates  whether  a  command  byte  (port 
64H)  or  a  data  byte  ^rt  60H)  is  involved. 

In  addition  to  this  flag,  bits  0  and  1  of  the  keyboard  status  registo*  are  especially 
important  for  communication  with  the  keybo^.  Bit  0  indicates  the  status  of  the 
output  buffer.  If  this  bit  is  1,  then  the  output  buffer  of  the  keyboard  contains 
information  which  has  not  yet  been  read  from  pwt  60H.  Reading  from  this  port 
will  automatically  set  this  bit  back  to  0,  indicating  that  there  is  no  longer  a 
character  in  the  output  buffer. 

Bit  1  (tf  the  status  register  is  always  set  whenever  the  system  has  placed  a  character 
in  the  input  buffer,  befcve  this  character  is  processed  by  the  keyboard.  Nothing 
should  be  written  to  the  keyboard  input  buffer  unless  this  bit  is  equal  to  0, 
signalling  that  the  input  buffer  is  empty. 

7  6  5  4  3  2  1  0  bit 


1  =  Output  buffer  full _ 

1_=_lngut_buffeMull^_^_ 

Command/data 
1  s  Output  from  port  64(h) 
0  s  Output  from  port  60(h) 

1  s  Keyboard  active 
1  X  Time  out  error  (output) 
1  X  Time  out  error  (Input) 

1  X  Parity  error 


AT  keyboard  controller  status  registers 

Of  the  various  commands  that  a  system  can  send  to  the  keyboard,  two  are  of 
interest  for  applications  programs  because  they  also  play  a  roll  outside  a  keyboard 
int^rupt  handler.  Hie  first  of  these  commands  sets  the  typemadc  or  repeat  rate  of 
the  keyboard.  This  is  the  number  of  make  codes  per  second  which  the  keyboard 
will  send  to  the  system  when  a  key  is  pressed  and  held  down.  It  can  be  between 
two  and  30  codes  per  second.  To  prevent  the  keys  horn  repeating  unintentionally, 
this  repeat  function  does  not  begin  until  after  a  certain  delay.  This  delay  time  can 
be  set  by  the  user  and  is  encoded  in  binary  as  follows: 
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ICodinQ  for  AT  keyboard  delay  rate  1 

Code 

Delay  rate 

00(b) 

1/4-second 

01(b) 

1/2-second 

10(b) 

1/4-second 

11(b) 

1  second 

The  keyboard  will  obs^e  these  times  with  a  toloance  of  ±20%. 

The  repeat  rate,  also  called  the  typematic  rate  by  IBM,  is  also  encoded  in  binary. 
The  following  table  shows  the  relationship  betwe«i  the  repeat  (typematic)  rate  and 
the  numbCT  of  rq)etiti(His  pa  second. 


1  Typematic  rate  codes  for  the  AT  keyboard  I 

Code 

RPS* 

Code 

RPS 

Code 

RPS 

Code 

RPS 

11111(b) 

2.0 

10111(b) 

4.0 

01111(b) 

8.0 

00111(b) 

16.0 

11110(b) 

2.1 

10110(b) 

4.3 

01110(b) 

8.6 

00110(b) 

17.1 

11101(b) 

10101(b) 

4.6 

01101(b) 

Kn 

00101(b) 

18.5 

11100(b) 

2.5 

10100(b) 

5.0 

01100(b) 

i6.o 

00100(b) 

20.0 

11011(b) 

2.7 

10011(b) 

5.5 

01011(b) 

10.9 

00011 (b) 

21.8 

11010(b) 

3.0 

10010(b) 

6.0 

01010(b) 

12.0 

00010(b) 

HiPM 

11001(b) 

3.3 

10001(b) 

6.7 

01001(b) 

lESI 

00001(b) 

11000(b) 

3.7 

10000(b) 

7.5 

01000(b) 

15.0 

00000(b) 

KBICT 

This  relationship  may  seem  somewhat  arbitrary  at  first,  but  it  does  foUow  a 
mathematical  formula.  The  binary  value  of  bits  0, 1,  and  2  of  the  repeat  rate  form 
variable  A,  and  the  binary  value  of  bits  3  and4  form  variaUe  B: 

(8  +  A)  *  2®  *  0.00417  *  1/second 

The  delay  and  rq)eat  rate  values  are  combined  into  a  byte  by  placing  the  five  bits 
of  the  rq)eat  rate  in  front  of  the  delay  value.  However,  we  can't  just  send  this  value 
straight  to  the  keyboard.  We  must  first  send  the  ^jfHopriate  cmnmand  code  (34H) 
and  then  the  repeat  parameters.  Both  bytes  must  be  sent  to  port  60H,  but  we 
cannot  just  send  them  with  an  OUT  instruction.  We  have  to  use  a  transmission 
protocol  which  includes  reading  the  keyboard  status,  and  which  also  accounts  for 
the  possibility  that  the  transfn'  might  not  work  the  first  time.  Since  we  have  to  do 
this  for  both  bytes,  we  should  write  a  subroutine  to  do  it.  The  structure  of  this 
subroutine  is  shown  in  the  following  flowcharL 
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Program  flowchart— byte  tranter  via  keyboard 
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We  first  load  an  error  counter  which  allows  the  routine  to  try  to  send  the  byte  three 
times  before  an  error  is  returned.  Then  the  keyboard  status  port  is  read  in  a  loop 
until  bit  0  is  cleared  and  the  input  buffer  of  the  keyboard  is  empty.  Then  we  can 
send  the  character  to  port  60H.  To  make  sure  that  the  chaiacto*  got  thoe  all  right  (a 
parity  emn'  might  have  occurred,  for  example),  the  keyboard  sends  back  a  reply 
code.  This  has  been  received  when  bit  1  of  the  keyboard  status  port  is  set 

This  register  is  again  read  fiom  port  64H  in  a  loop  until  this  condition  is  met 
Now  we  can  read  the  reply  to  our  transmission  fiom  the  keyboard  data  port  If  it  is 
the  code  OFAH,  which  stands  for  "acknowledge,”  the  transmission  was  successful. 
Any  other  code  indicates  an  oror,  which  tells  the  sulnoutine  to  decrement  the  oror 
counter  and  rqteat  the  whole  process,  provided  the  counto*  has  not  reached  zero.  In 
this  case  the  sulnoutine  ends  and  signals  an  oror  to  the  callo*. 

Demonstration  programs 

To  give  you  an  example  of  how  this  works,  the  following  pages  contain  programs 
in  BASIC,  Pascal,  and  C  which  you  can  use  to  set  the  key  repeat  parameters  on 
your  keyboard.  The  heart  of  these  programs  is  an  ass^bly  language  routine  which 
sends  the  parameters  to  the  keyboard.  Within  this  routine  is  the  subroutine  we  just 
discussed,  which  is  first  called  to  send  the  Set  Typematic  instruction  to  the 
keyboard.  Anodic  call  is  used  to  send  the  paiametos  toemselves. 

In  the  Pascal  and  C  versions,  the  key  repeat  rate  and  the  delay  values  are  specified 
as  separate  parameta-s  following  the  program  name  entered  at  the  DOS  prompt 
Naturally  this  is  not  possible  in  GW-BASIC,  so  the  two  parameters  are  read 
within  the  program  wito  the  INPUT  command. 

We  also  included  the  listing  of  the  assembly  routines  for  the  various  programs. 
The  BASIC  and  Pascal  programs  include  these  with  DATA  or  INLINE  statements; 
the  linker  links  these  statements  to  the  C  version  of  the  program. 

To  see  the  effect  of  the  key  repeat  rate,  first  try  setting  the  smallest  repeat  rate  (0) 
and  then  the  highest  rate  (30).  Try  pressing  and  holding  a  key  at  each  of  these 
settings  to  see  the  results. 

BASIC  listing:  TYPMB.BAS 

100  •**********♦***★**★**★**★****★************★****★★*******★***★★★***★• 

110  •*  T  Y  P  M  B  *• 

120  •* - *• 

130  •*  Description  :  Sets  the  key  repeat  rate  of  the  AT  keyboard.  *• 

150  •*  Author  :  MICHAEL  TISCHER  *' 

160  '*  developed  on  ;  09/08/1988  *' 

170  '*  last  update  :  09/08/1988  *' 

180  •*****************★★*****★*********★******★******★★**★★*★**★***★*★*• 

190  • 

200  CLS  :  KEY  OFF 

210  PRINT  "Note;  This  program  may  be  run  only  if  GWBASIC  has  been  started"; 

220  PRINT  "from  the  DOS  level" 

230  PRINT  "with  the  conmand  <GWBASIC  /m:60000>  and  the  computer  is  an  AT." 

260  PRINT  :  PRINT"If  this  is  not  the  case,  then  please  enter  <s>  for  Stop." 

280  PRINT  "Otherwise  press  any  other  key..."; 
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290  A$  =  INKEY$  :  IF  A$  -  «s"  THEN  END 
300  IF  A$  *  THEN  290 

310  CLS  'clear  screen 

320  GOSUB  60000  'install  assembler  routine 

330  PRINT  "TYPMB  -  (c)  1988  by  MICHAEL  TISCHER" 

340  PRINT  "Sets  the  repeat  rate  of  the  AT  keyboard."  :  PRINT 
350  INPUT  "Delay  before  repeat  (O-minimum,  3-maximuin)  "7V% 

360  IF  V%<0  OR  V%>3  THEN  350 

370  INPUT  "Key  repeat  rate  (30=fninimum,  O^maximum)  ";W% 

380  IF  W%<0  OR  W%>30  THEN  370 
390  TYPRATE%  *  V%  *  32  +  W% 

400  CALL  TR(TYPRATE%,  OK%)  'set  key  repeat  rate 

410  IF  NOT  OK%  THEN  440 

420  PRINT  "The  key  repeat  rate  has  been  set." 

430  END 
440  PRINT 
450  END 
460  ' 

60000 
60010 
60020 
60030 
60040 
60050 
60060 
60070 
60080 
60090 
60100 
60110 
60120 
60130 
60140 
60150 
60160 
60170 
60180 


"Error  accessing  the  keyboard  controller." 

*  -kit-klfk-k  ******** -k-k-kick-k-klc-k-k-k-k-k-k*  ******** -k-k-kick-kicklc-k-k-k-k-k*  *******  • 

*  Install  the  routine  for  setting  the  key  repeat  rate.  *' 


*  Input  :  none  *' 

*  Output:  TR  is  the  start  address  of  the  assembler  routine  *' 

*  Calling  the  routine:  CALL  TR(TYPRATE%,  OK%)  *' 

********************-k-k**-k-k-k*-k-k-k-k**  ***************  ******  *********  • 


TR*60000! 

DEF  SEG 
RESTORE  60140 
FOR  1%  -  0  TO  71 
RETURN 


'start  addr  of  the  routine  in  the  BASIC  segment 

•set  BASIC  segment 


READ  X%  :  POKE  TR+I%,X% 


NEXT  'poke  routine 
'back  to  the  caller 


DATA  85,139,236,  51,210,180,243,250,232,  23,  0,117,  11,139,  94 

DATA  8,138,  39,232,  13,  0,117,  1,  74,251,139,  94,  6,137,  23 
DATA  93,202,  4,  0,  81,  83,179,  3,  51,201,228,100,168,  2,224 
DATA  250,138,196,230,  96,228,100,168,  1,225,250,228,  96,  60,250 

DATA  116,  7,254,203,117,230,128,203,  1,  91,  89,195 


Assembler  listing:  TYPMBA.ASM 


.★★★*★**★*★★*★*★★*★**★*★★**★★**★**★***★★*★★*★**★****★★★★*★**★**★*★*★★*★. 


•  ★ 
r 

TYPMBA 

★  > 

f 

•  * 
t 

•  * 

.* _ 

Description 

:  Assembler  routine  for  use  with  a  GWBASIC 
program,  which  sets  the  key  repeat  rate  of 
AT  keyboard. 

★  • 

the  *; 

*• 

•  * 

Author 

:  MICHAEL  TISCHER 

★  • 

•  * 

developed  on 

:  27.08.1988 

★  • 

•  * 
r 

•  * _ 

last  update 

;  27.08.1988 

;*  to  assemble  :  MASM  TYPMBA;  *; 
;*  LINK  TYPMBA  *; 
;*  EXE2BIN  TYPMBA  TYPMBA.BIN  *} 
;*  ...  convert  to  DATA  statements  and  insert  in  *; 
;*  a  BASIC  program  *; 
;  *************************  *******-11  ************************************** 


;==  Constants 


KB  STATUS  P 

equ  64h 

/status  port  of  the  keyboard 

KB_DATA_P 

equ  60h 

/keyboard  data  port 

OB_FULL 

equ  1 

/Bit  0  in  the  keyboard  status  port 
/one  character  in  the  output  buffer 

IB_FULL 

equ  2 

/Bit  1  in  the  keyboard  status  port 
/one  character  in  the  input  buffer 

ACK_SIGNAL 

equ  Of ah 

/keyboard  acknowledge  signal 
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SET_TYPEM  equ  0f3h  ; set-key-repeat  code 

MAXJTRY  equ  3  ;  number  of  retries 

code  segment  para  'C(X)E'  ;definltlon  of  the  CODE  segment 

org  10 Oh 

assume  cs:code,  ds:code,  ssicode,  esicode 


; —  SET_TYPM:  Determines  the  key  repeat  rate  to  be  sent  to  the  — 
; —  keyboard  controller 

Call  ;  CALL  Adresse  (TYPRATE%,  OK%> 

; —  Info  :  If  the  key  repeat  rate  can  be  set,  the  value  will  be 

; —  placed  in  TYPRATE,  else  0 


set_typni  proc  far 


;GW  expects  FAR  procedures 


sframe  struc 

bptr  dw  ? 

ret_adr  dd  ? 

ok_adr  dw  ? 

tr_adr  dw  ? 

sframe  ends 


; structure  for  accessing  the  stack 
; stores  BP 

/return  address  to  the  caller 
; (FAR  address) 

/address  of  the  OK  variable 
/address  of  the  var  with  the  rep  rate 
/end  of  the  structure 


frame  equ  [  bp  -  bptr  ] 


/addresses  the  elements  of  the  structure 


push  bp 
mov  bp, sp 

xor  dx, dx 

mov  ah, SETJTYPEM 

cli 

call  send_kb 
jne  error 

mov  bx, frame. tr_adr 
mov  ah, [bx] 
call  send_kb 
jne  error 

dec  dx 

error;  sti 

mov  bx,  frame .  ok_adr 
mov  [bxl,dx 
pop  bp 
ret  4 

set_typfn  endp 


/save  BP  on  the  stack 
/transfer  SP  to  BP 

/assume  transfer  failed 

/set  command  code  for  key  rep  rate 

/disable  Interrupts 

/send  to  the  controller 

/error?  yes  — >  Error 

/get  address  of  the  TYPRATE  variable 
/get  key  repeat  rate 
/send  to  the  controller 
/error?  yes  — >  Error 

/everything  OK,  return  -1 

/allow  Interrupts  again 

/get  address  of  the  OK  variable 

/put  error  static  there 

/get  BP  back  from  stack 

/back  to  GW-BASIC  and  remove  the 

/variables  from  the  stack 


/ —  SEND_KB;  send  a  byte  to  the  keyboard  controller  - 

/ —  Input  :  AH  *  the  byte  to  be  sent 

/ —  Output  :  zero  flag:  0==error,  l=OK 

/ —  Registers;  AX  and  the  flag  register  are  used 
/ —  Info  ;  this  routine  is  Intended  for  use  only  within  this 
/ —  module 

send_kb  proc  near 

push  cx  /save  all  registers  used  in  this 

push  bx  /routine  on  the  stack 

mov  bl,MAX_TRY  /maximum  of  MAX_TRY  retries 
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; —  wait  until  the  controller  is  ready  to  receive  data 


skb  1: 
skb_2: 

xor  cx, cx 
in  al,KB  STATUS  P 
test  al,IB_FULL 
loopne  skb_2 

;maximum  of  65536  loop  passes 
;read  contents  of  the  status  port 
; still  a  character  in  the  input  buffer? 
;yes  — >  SKB_2 

; —  send  character  to 

the  controller  - 

skb_3: 

mov  al,ah 
out  KB  DATA  P,al 
in  al,KB_STATUS_P 
test  al,OB_FUIjL 
loope  skb_3 

;get  character  in  AL 
;send  character  to  the  data  port 
;read  contents  of  the  status  port 
; answer  in  the  output  buffer? 

;no  — >  SKB_3 

; —  get  reply  from  controller  and  evaluate  - 

in  al,KB_DATA_P 
cmp  al,ACK_SIGNAL 
je  skb_end 

;read  reply  from  data  port 
;was  the  character  accepted? 

;YES  — >  everything  OK 

; —  the  character  was 

not  accepted  - 

dec  bl 
jne  skb__2 

;decreirffint  error  counter 
; retries  left? 

;YES  -->  SKB_2 

or  bl,l 

;NO,  set  zero  flag  to  0,  indicating 
;an  error 

skb_end: 

pop  bx 
pop  cx 
ret 

/restore  the  registers  from  the  stack 

/back  to  the  caller 

send_kb 

endp 

; ——  Ende 

code 

ends 

end  set_typni 

/end  of  the  code  segment 

listing:  TYPMP.PAS 

^ ***★***•*★***★****★*★****★★*★★**★**★**★**★***★*****★************ *★★****] 


{*  T  Y  P  M  P  *} 

(* - *} 

{*  Description  :  Sets  the  key  repeat  rate  of  the  AT  keyboard.  ’►I 

- *} 

{*  Author  :  MICHAEL  TISCHER  *) 

{*  developed  on  :  08/27/1988  *} 

{*  last  update  :  08/27/1988  *} 


program  TYPMP; 


{*  SetTyjxn:  Sends  the  key  repeat  rate  to  the  keyboard  controller  *} 
{*  Input  :  RATE  :  the  repeat  rate  to  be  set  *} 
{*  Output  :  TRUE,  if  the  value  was  set,  FALSE  if  an  error  occurred  *} 
{*  accessing  the  controller  *} 
{*  Info  :  This  function  can  be  bound  into  a  UNIT  *} 


^  ********************************************************************** } 

{$F+}  {  this  function  uses  the  FAR  call  model  } 

function  SetTypm(  Rate  :  byte  )  :  boolean; 

begin 
inline ( 
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$32/$D2/$B4/$F3/$FA/$E8/$13/$00/$75/$0A/$8A/$66/$06/$E8/ 

$0B/$00/$75/$02/$FE/$C2/$FB/$88/$56/$FF/$EB/$27/$90/$51/ 

$53/$B3/$03/$33/$C9/$E4/$64/$A8/$02/$E0/$FA/$8A/$C4/$E6/ 

$60/$E4/$64/$A8/$01/$El/$FA/$E4/$60/$3C/$FA/$74/$07/$FE/ 

$CB/$75/$E6/$80/$CB/$01/$5B/$59/$C3 

); 

end; 


{$F-} 


^  ************************************************  J 

{**  MAIN  PROGEIAM  **) 

^ ★**********★**★**★*****★*******★***★*★** *********************** ******* } 


var  Delay, 
Speed, 
Fposl, 
FPos2 
ParErr 


:  integer; 
boolean; 


{  stores  the  delay  } 
{  stores  the  key  repeat  rate  } 

{  error  position  in  string  conversion  } 
{  error  in  parameter  passing  } 


begin 

writeln(#13#10, 'TYPMP 
ParErr  true; 
if  ParamCount  =  2  then 
begin 

val (ParamStr (1) ,  Delay,  FPosl) ; 
val (ParamStr (2) ,  Speed,  FPos2) ; 
if  ((FPosl«0)  and  (FPos2=0) )  then 
if  ( (Delay  <  4)  and  (Speed  <32) ) 
ParErr  ;=  false; 

end; 

if  (  ParErr  )  then 
begin 

writeln  (Call  :  TYPMP 
writelnC 
writeln ( ' 


-  (c)  1988  by  MICHAEL  TISCHER'); 

{  assume  error  in  parameters  } 
{  were  2  parameters  passed?  } 
{  YES  } 

{  first  parameter  to  integer  } 
{  second  parameter  to  integer  } 
{  error  in  conversion?  } 
then  {  no,  value  OK?  } 

{  yes,  then  parameters  are  OK  } 


delay 


{  are  parameters  OK?  } 
{  no  } 

key_repeat_rate ' ) ; 


•,#30,' 


I 


!•); 


Vertical  line  can  be  created  using  <Alt><179>; 
writelnC  f - ^1 - 1  T - J-- 


•,#30); 


Upper  left  comer  can  be  created  using  <Alt><218>; 
Horizontal  line  can  be  created  using  <Alt><196>; 

Brace  pointing  'up'  can  be  created  using  <Alt><193>; 

Upper  right  comer  can  be  created  using  <Alt><191> 
writelnC  I  0  ;  1/4  second  I  I  0  :  30.0  r&p./s. 

Vertical  line  can  be  created  using  <Alt><179>; 

writelnC  I  1  :  1/2  second  111:  26.7  resp./s. 

writelnC  I  2  :  3/4  second  I  I  2  :  24.0  rep./s. 

writelnC  I  3  :  1  second  I  I  3  :  21.8  rep./s. 

writelnC  •{ - •{  I 

Left  brace  can  be  created  using  <Alt><195>; 

Horizontal  line  can  be  created  using  <Alt><196>; 

Right  brace  can  be  created  using  <Alt><180>; 
writelnC  I  all  values  q20%  I  I 

writeln  ( '  L - J  I 

Lower  left  corner  can  be  created  using  <Alt><192>; 
Horizontal  line  can  be  created  using  <Alt><196>; 

Lower  right  corner  can  be  created  using  <Alt><217>; 

writelnC  I  28  :  2.5  rep./s. 

Vertical  line  can  be  created  using  <Alt><179>; 

writelnC  I  29  :  2.3  rep./s. 

writelnC  I  30  :  2.1  rep./s. 

writelnC  I  31  :  2.0  rep./s. 

writeln ( *  L - 

Lower  left  comer  can  be  created  using  <Alt><192>; 
Horizontal  line  can  be  created  using  <Alt><196>; 

Lower  right  corner  can  be  created  using  <Alt><217>; 
end 


!•); 

h; 

h; 

h; 


I*); 


!•); 

!•); 


h; 

h; 

1'); 

!•); 

-J'); 
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else  {  the  parameters  are  OK  } 

begin 

V  if  (SetTypm(  (Delay  shl  5)  +  Speed  ))  then  {  set  Jcey  repeat  rate  } 
writelnCThe  keboard  repeat  rate  was  set.') 
else 

writelnC ERROR  accessing  the  keyboard  controller.'); 

end; 

end. 

Assembler  listing:  TYPMPA.ASM 


*-kifkic-k-k-k-k-kifk-k*-k*-k*-k**-k-k*-k**ifk*-kifkit*i(*-k*-k-kifk-k-k-k1(ifk1ck-kifk1fk1t1t*-k1fk1fkifk1fk1t 

T  Y  P  M  P  A  * 


Description 


Assanbler  routine  for  use  with  a  Turbo  Pascal  *; 
program,  which  sets  the  key  repeat  rate  of  the  *; 
AT  keyboard.  *; 


Author 
developed  on 
last  update 


MICHAEL  TISCHER 

27.08.1988 

27.08.1988 


;*  to  assemble  :  MASM  TYPMPA;  *; 

;*  LINK  TYPMPA  *; 

;*  EXE2BIN  TYPMPA  TYPMPA.BIN  *; 

;*  ...  convert  to  INLINE  statements  *; 

.********★***************★*★*****★*************★**★**★*★★****★★*★★****★. 


;==  Constants 


KB_STATUS_ 

_P  equ  64h 

; status  port  of  the  keyboard 

KB_DATA_P~ 

equ  60h 

; keyboard  data  port 

0B_FULL 

equ  1 

;Bit  0  in  the  keyboard  status  port 
;one  character  in  the  output  buffer 

IB_FULL 

equ  2 

;Bit  1  in  the  keyboard  status  port 
;one  character  in  the  input  buffer 

ACK_SIGNAL  equ  Of ah 

; keyboard  acknowledge  signal 

SET_TYPEM 

equ  0f3h 

; set-key-repeat  code 

MAX_TRY 

equ  3 

,m  code  ============== 

; number  of  retries 

;  Progrc 

code 

segment  para  'CODE' 

;definition  of  the  CODE  segment 

org  lOOh 


assume  cs:code,  dsicode,  ssicode,  esrcode 


t 

;—  SET  TYPM:  Determines 

the  key  repeat  rate  to  be  sent  to  the 

} 

keyboard  controller 

; —  Info 

:  Set  up  as  a 

NEAR  call 

set_typtn 

proc  near 

;GW  expects  FAR  procedures 

sframeO 

St  rue 

; structure  for  accessing  the 

stack 

bpO 

dw  ? 

; stores  BP 

ret_adr0 

dd  ? 

; return  address  to  the  caller 
; (FAR  address) 

trateO 

dw  ? 

; address  of  the  var  with  the 

rep  rate 

sframeO 

ends 

;end  of  the  structure 

frame 

equ  [  bp  -  bpO 

]  ; addresses  the  elements  of  the  structure 

;The  following  instructions  are  executed  by  Turbo 

; 

push  bp 

;save  BP  on  the  stack 
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mov 

bp,  sp 

/transfer  SP  to  BP 

xor 

dl,dl 

/assume  transfer  failed 

mov 

ah, SET  TYPEM 

/set  ccxtmand  code  for  key  rep  rate 

cll 

/disable  interrupts 

call 

send  kb 

/send  to  the  controller 

jne 

error 

/error?  yes  — >  Error 

mov 

ah, byte  ptr  frame. trateO  ;get  address  of  the  TYPRATE  variable 

call 

send  kb 

/send  to  the  controller 

jne 

error 

/error?  yes  — >  Error 

Inc 

dl 

/everything  OK,  return  TRUE 

error: 

stl 

/allow  interrupts  again 

mov 

[bp-l],dl 

/put  error  static  there 

pop 

bp 

/get  BP  back  from  stack 

jmp  ende 

/back  to  Turbo  Pascal 

set_typm 

endp 

; —  SEND  KB;  send  a  byte  to  the  keyboard  controller  - 

; —  Input 

: 

AH  =  the  byte 

to  be  sent 

; —  Output 

: 

zero  flag:  0=error,  l*OK 

; —  Registers; 

AX  and  the  flag  register  are  used 

Info 

: 

this  routine 

Ls  intended  for  use  only  within  this 

module 


send_kb  proc  near 

push  cx  ;save  all  registers  used  In  this 

push  bx  /routine  on  the  stack 

mov  bl,MAX_TRY  /maxlmmn  of  MAXJTRY  retries 


; —  wait  until  the  controller  Is  ready  to  receive  data 


skb  1: 

xor 

cx,  cx 

/maximum  of  65536  loop  passes 

skb  2: 

In 

al,KB  STATUS  P 

/read  contents  of  the  status  port 

test 

al,IB  FULL 

/still  a  character  In  the  input  buffer? 

loopne  skb  2 

;yes  — >  SKB_2 

/  "" 

send  character  to 

the  controller  - 

mov 

al,ah 

/get  character  in  AL 

out 

KB  DATA  P,al 

/send  character  to  the  data  port 

skb  3; 

in 

al,KB  STATUS  P 

/read  contents  of  the  status  port 

test 

al,OB  FULL 

/answer  In  the  output  buffer? 

loope  skb  3 

/no  — >  SKB_3 

get  reply  from  controller  and  evaluate  - 

in 

al,KB  DATA  P 

/read  reply  from  data  port 

cmp 

al,ACK  SIGNAL 

/was  the  character  accepted? 

je 

skb  end 

/YES  — >  everything  OK 

the  character  was 

not  accepted  - 

dec 

bl 

/decrement  error  counter 

jne 

skb  2 

/retries  left? 

/YES  — >  SKB_2 

or 

bl,l 

/NO,  set  zero  flag  to  0,  indicating 

/an  error 

skb_end; 

pop 

bx 

/restore  the  registers  from  the  stack 

pop 

cx 

ret 

/back  to  the  caller 

send_kb 

endp 
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ende  label  near 

code  ends  ;end  of  the  code  segment 

end  set_typm 


C  listing;  TYPMC.C 

/ -kit  it -k-kltit  ***************************************************************  / 


/*  T  Y  P  M  C  */ 

/* - */ 

/*  Description  :  Sets  the  key  repeat  rate  on  the  AT  keyboard  */ 
/*  according  to  the  preferences  of  the  user.  */ 

/* - */ 

/*  Author  ;  MICHAEL  TISCHER  */ 

/*  developed  on  :  08/28/1988  */ 

/*  last  update  :  08/28/1988  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  creation  ;  CL  /AS  /c  TYPMC.C  */ 

/*  LINK  TYPMC  TYPMCA;  */ 

/*  call  :  TYPMC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  creation  :  via  project  file  with  following  contents:  */ 

/*  TYPMC  */ 

/*  TYPMCA.  OBJ  */ 

/********************************************************************** / 

/*=-  Include  files 

♦include  <stdllb.h> 

typedef  unsigned  char  byte;  /*  build  ourselves  a  byte  */ 

typedef  byte  bool;  /*  always  TRUE  or  FALSE  */ 

/*==  Constants 

♦define  TRUE  1  /*  needed  for  working  with  BOOL  */ 

♦define  FALSE  0 

/*==  Declaration  of  external  functions  in  the  assenbler  module  ======*=*/ 

extern  bool  set_typm(  byte  trate  );  /*  sets  the  key  repeat  rate  */ 

/**********************************************************************  f 

/**  MAIN  PROGRAM  **/ 


f ********** ********************-k*************************************** / 


void  main(int  argc,  char  *argv[]  ) 

{ 

int  delay,  /*  stores  the  specified  delay  */ 

speed;  /*  stores  the  specified  repeat  rate  */ 

print f(-\nTYPMC  -  (c)  1988  by  MICHAEL  TISCHERVn") ; 

if  (argc!=3  ||  (  (delay  =  atoi (argv[l] ) ) <0  ||  delay>3  )  || 

(  (speed  =  atoi (argv[2] ) )<0  ||  speed>31  )) 

{  /*  illegal  parameters  were  passed  */ 

print f  (••call:  TYPMC  delay  key_repeat_rate\n'')  ; 

printf(^'  \xle  NxleNn^*); 


printf(^^  I  Kn-); 

/*  Vertical  line  can  be  created  using  <Alt><179>;  */ 

printf(’^  r - - 1  r - 1 - l'\n^*); 

/*  U^Jer  left  corner  can  be  created  using  <Alt><218>;  */ 
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/*  Horizontal  line  can  be  created  using  <Alt><196>;  */ 

/*  Brace  pointing  'up*  can  be  created  using  <Alt><193>;  */ 

/*  Upper  right  corner  can  be  created  using  <Alt><191>  */ 

print f (•*  I  0  :  1/4  second  I  I  0  :  30.0  rep./s.  Kn"); 

/*  Vertical  line  can  be  created  using  <Alt><179>;  */ 

printf{"  I  1  :  1/2  second  111:  26.7  rep./s.  Kn**); 

print f  (••  I  2  :  3/4  second  I  I  2  :  24.0  rep./s.  Kn"); 

printfC  I  3  :  1  second  I  I  3  :  21.8  rep./s.  Kn"); 

printf{"  - I  .  Kn"); 

/*  Left  brace  can  be  created  using  <Alt><195>;  */ 

/*  Horizontal  line  can  be  created  using  <Alt><196>;  */ 

/*  Right  brace  can  be  created  using  <Alt><180>;  */ 

printfC  I  all  values  q20%  I  I  .  Kn"); 

printfC  L - J  I  .  Kn"); 

/*  Lower  left  corner  can  be  created  using  <Alt><192>;  */ 

/*  Horizontal  line  can  be  created  using  <Alt><196>;  */ 

/*  Lower  right  comer  can  be  created  using  <Alt><217>;  */ 

printfC  I  28  :  2.5  rep. /s.  Kn")  ; 

/*  Vertical  line  can  be  created  using  <Alt><179>;  */ 

printf{"  I  29  :  2.3  rep./s.  I\n") ; 

printf("  I  30  :  2.1  rep./s.  Kn") ; 

printfC  I  31  :  2.0  rep./s.  I\n") ; 

printf("  L - J\n"); 

/*  Lower  left  comer  can  be  created  using  <Alt><192>;  */ 

/*  Horizontal  line  can  be  created  using  <Alt><196>;  */ 

/*  Lower  right  corner  can  be  created  using  <Alt><217>;  */ 

} 

else  /*  the  parametes  are  OK  */ 

{ 

if  (set_typin(  (delay  «  5)  +  speed  ))  /*  set  repeat  rate  */ 

printf  ("The  keyboard  repeat  rate  was  set.\n"); 
else 

printf ("ERROR  accessing  the  keyboard  controller. \n" ) ; 

} 


Assembler  listing:  TYPMCA.ASM 


.********************************************************************** 
;*  T  Y  P  M  C  A  * 


Description  :  Assembler  routine  for  setting  the  key  repeat 
rate  on  an  AT  keyboard.  For  linking  with  a 
C  program. 


Author  :  MICHAEL  TISCHER 

developed  on  :  08/27/1988 

last  update  :  08/27/1988 


to  assembler  :  MASM  TYPMCA; 

. . .  link  with  a  C  program 


m  **-k-k-k****-k*-k1t*i(******-kifkit*it*it*-kifk  ******* -kick  it  ****  it*****  ****************  . 


;==  Constants  ========= 

KB_STATUS_P  equ  64h 
KB_DATA_P  equ  60h 

OB_FULL  equ  1 

IB_FULL  equ  2 

ACK_SIGNAL  equ  Ofah 

SET_TYPEM  equ  0f3h 


; keyboard  status  port 
; keyboard  data  port 

;bit  0  in  keyboard  status  port 
;a  character  in  the  output  buffer 
;bit  1  in  the  keyboard  status  port 
;a  character  in  the  input  buffer 

; keyboard  acknowledge  signal 
; set -repeat-rate  code 
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MAX_TRY  equ  3 


; number  of  retries  allowed 


;»  Segment  declarations  for  the  C  program 


IGRCXJP  group  _text  ;coirtoination  of  the  program  segments 

DGROUP  group  const, _bss,  _data  ; combination  of  the  data  segments 
assume  CSiIGROUP,  DS:DGROUP,  ESrDGROUP,  SSrDGROUP 


CC»JST  segment  word  public  ' CONST ';this  segment  stores  all  of  the 
CC»IST  ends  /read-only  constants 


BSS 

BSS 


segment  word  public  'BSS*  /this  segment  stores  all  of  the 
ends  /uninitialized  static  variables 


DATA 

DATA 


segment  word  public  'DATA* 
ends 


/all  initialized  global  and  static 
/variables  are  stored  in  this  segment 


/»“  Program 


_TEXT  segment  byte  public  'CCXJE*  /the  program  segment 
publ i c  _set_t  ypm 


—  SET_TYPM:  sends  the  key  repeat  rate  to  the  keyboard  controller 

—  Call  from  C  :  bool  set_typem(  byte  trate  )/ 

—  Return  value:  TRUE,  if  the  repeat  rate  was  set 

FALSE,  if  an  error  occurred 


_set_typni  proc  near 

sframeO  struc 

bpO  dw  ? 

ret__adrO  dw  ? 

trateO  dw  ? 

sframeO  ends 


/structure  for  accessing  the  stack 
/stores  BP 

/return  address  to  caller 
/repeat  rate  to  be  set 
/end  of  the  structure 


frame  equ  [  bp  -  bpO  ] 


/addresses  the  elements  of  the  structure 


push  /save  BP  on  the  stack 

mov  bp, sp  /transfer  SP  to  BP 


xor  dx,  dx 

mov  ah, SET_TYPEM 

cli 

call  send_kb 
jne  error 

mov  ah, byte  ptr  J 
call  send_kb 
jne  error 

Inc  dl 

error:  sti 

mov  ax, dx 
pop  bp 
ret 

_set_typm  endp 


/assume  transfer  fails 
/set  COTimand  code  for  rep  rate 
/disable  interrupts 
/send  to  the  controller 
/error?  YES  — >  Error 

.trateO  /get  key  repeat  rate 
/send  to  the  controller 
/error?  YES  — >  Error 

/everything  OK,  return  TRUE 

/allow  interrupts  again 
/return  value  to  AX 
/get  BP  back  frcxn  stack 
/back  to  the  C  program 


/ —  SEND_KB:  send  a  byte  to  the  keyboard  controller  - 

/ —  Input  :  AH  =  the  byte  to  be  sent 

/ —  Output  :  zero  flag:  0=error,  l*OK 

/ —  Registers:  AX  and  the  flag  register  are  changed 
/ —  Info  :  This  routine  is  to  be  called  only  within  the  module 

send_kb  proc  near 
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push  cx 
push  bx 


;save  all  registers  which  are  changed 
;ln  this  routine  on  the  stack 


mov  bl,MAX_TRY  ;maximum  of  MAX_TRY  retries 

; —  wait  until  the  controller  is  ready  to  receive  data  - 


slcb_l :  xor  cx,  cx 

slcb_2:  in  al,KB__3TATUS_P 

test  al,IB_FULL 
loopne  skb_2 


;maxiinum  of  65536  loop  passes 
;read  contents  of  status  port 
; still  a  char  in  the  input  buffer? 
;YES  —>  SKB_2 


; —  send  character  to  the  controller 


mov  al,ah 
out  KB_DATA__P,al 
skb_3 :  in  a  1 ,  KB_STATUS_P 

test  al,OB_FULL 
loope  skb_3 


;get  character  in  AL 
;send  character  to  the  data  port 
;read  contents  of  the  status  port 
; reply  in  output  buffer? 

;N0  — >  SKB_3 


; —  get  and  evaluate  relpy  from  controller 


in  al,KBJDATA_P 
cmp  al,ACK_SIGNAL 
je  skb_end 


;read  reply  from  data  port 
;was  the  character  accepted? 
;YES  — >  everything  OK 


; —  the  character  was  not  accepted 


skb  end: 


send  kb 


dec  bl 
jne  skb_2 


or  bl,l 


pop  bx 
pop  cx 
ret 

endp 


; decrement  error  counter 
; still  retries  left? 

;YES  — >  SKB_2 

;N0,  set  zero  flag  to  0  to  indicate 
;the  error 

/restore  the  registers  from  the  stack 
/return  to  caller 


_text  ends  /end  of  the  code  segment 

end  /end  of  the  program 

We  can  use  this  same  method  to  turn  the  LEDs  on  the  AT  keyboard  on  and  off. 
The  corresponding  instruction  code  is  number  OEDH,  and  is  called  the  Set/Reset 
Mode  Indicators  instruction. 

After  this  ccxnmand  code  has  been  successfully  transmitted,  the  keyboard  waits  for 
a  byte  which  reflects  the  status  of  the  three  LEDs.  One  bit  in  this  byte  stands  for 
one  of  the  three  LEDs,  which  is  turned  on  when  the  corresponding  bit  is  set 


Bit  # 

LED 

0 

Scroll  Lock 

1 

Num  Lock 

2 

Caps  Lock 

Bits  3-7 

unused 
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Setting  and  resetting  these  bits  make  sense  only  when  the  keyboard  mode  which 
they  indicate  is  enabled  or  disabled. 

These  modes  are  managed  in  the  BIOS,  not  the  keyboard.  For  example,  the 
keyboard  doesn't  automatically  convert  all  of  the  letters  to  uppercase  in  Caps  Lock 
mode.  The  keyboard  can  only  associate  a  key  with  a  virtual  key  number,  rather 
than  a  specific  character.  This  key  number  is  then  converted  to  an  ASCII  or 
extended  keyboard  code  by  the  BIOS.  Naturally  this  also  applies  to  the  Caps  Lock 
key,  which  simply  sends  a  scan  code  to  the  computer  when  it  is  pressed.  The  BIOS 
assigns  the  C^s  Lock  function  to  this  key  by  setting  an  internal  flag  which  marks 
this  mode  as  active,  then  sends  the  Set/Reset  Mode  Indicators  instruction  to  the 
keyboard  to  light  the  apix*opriate  LED. 

Although  these  keyboard  modes  are  normally  enabled  and  disabled  by  the  user 
pressing  the  corresponding  keys,  it  may  be  useful  to  set  a  mode  from  within  a 
program.  This  is  the  case  for  keyboards  which  have  separate  cursor  keys  and  a 
numerical  keypad,  for  example.  Since  most  keyboards  can  only  enter  numbers 
when  Num  Lock  mode  is  on,  it  makes  sense  to  set  this  mode  automatically  when 
the  system  is  started. 

To  do  this  we  just  set  the  appropriate  BIOS  flag  and  then  turn  on  the 
corresponding  LED  on  the  keyboard  to  inform  the  user  that  this  mode  has  been 
activated. 

In  practice,  a  program  just  has  to  set  the  appropriate  BIOS  mode,  since  the  BIOS 
automatically  controls  the  keyboard  LEDs.  Whenever  one  of  the  functions  of  the 
BIOS  keyboard  interrupt  is  called,  the  BIOS  checks  to  see  if  the  status  of  the  LEDs 
matches  the  keyboard  status,  as  indicated  in  an  internal  variable.  If  a  discrepancy 
arises,  the  BIOS  automatically  sets  the  LEDs  to  the  status  given  in  the  keyboard 
status  flag. 

Since  the  position  of  this  flag  in  the  BIOS  variable  segment  and  the  meaning  of 
the  individual  bits  is  completely  documented  (see  also  Section  7.14),  we  can  easily 
change  these  modes. 

The  following  programs  in  BASIC,  Pascal,  and  C  offer  routines  which  can  enable 
or  disable  the  individual  modes.  It  should  be  noted  that  although  PCs  and  XTs 
have  corresponding  LEDs,  these  programs  will  not  work  or  change  the  modes 
without  changing  the  status  of  the  LEDs  on  a  PC  or  XT  keyboard.  This  is  because 
these  keyboards  are  equipped  with  an  8048  processor,  which  does  not  offer  the 
ability  to  manage  the  LEDs.  The  fact  that  these  LEDs  do  turn  on  and  off  according 
to  the  modes  has  nothing  to  do  with  the  BIOS,  and  is  handled  directly  by  the 
keyboard. 
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listing:  LEDB.BAS 


100 

110 

120 

130 

140 

150 

160 

170 

180 


*  L  E  D  B 


*  Description 


Sets  the  various  bits  in  the  BIOS  keyboard 
flag,  causing  the  LED's  on  the  AT  keyboard 
to  flash. 

MICHAEL  TISCHER 

09/10/1988 

09/10/1988 


*  Author 

*  developed  on 

*  last  update 

it*  ************  Itit -k-klrlfkltltlfk  It***  ***  It*  mt-IHtlfkifk* -kit  it-k-k  it  ************  ****** 


190 
200 

210  CLS  :  KEY  OFF 

220  PRINT  "NOTE:  This  program  can  be  run  only  if  GWBASIC  was  started  from" 
230  PRINT  "the  DOS  level  with  the  command  <GWBASIC  /m:600000>  and  the" 

240  PRINT  "computer  is  an  AT." 

250  PRINT 

260  PRINT  "If  this  is  not  the  case,  please  enter  <s>  for  STOP." 

270  PRINT  "Otherwise  press  any  other  key..."; 

300  A$  -  INKEY$  :  IF  A$  =  "s"  THEN  END 
310  IF  A$  «  ""  THEN  300 
320  CLS 

330  GOSUB  60000  'install  routine  for  the  interrupt  call 

340  PRINT  "LEDB  -  (c)  1988  by  MICHAEL  TISCHER" 

350  PRINT  :  PRINT  "Watch  the  LEDs  on  your  keyboard!" 


TO  10 

CAPL%  :  GOSUB  50000 
1  TO  100  :  NEXT 


360  SCRL%  -  16 
370  NUML%  =  32 
380  CAPL%  =  64 
390  FOR  X%  =  1 
400  FLAGS% 

410  FOR  Y% 

420  GOSUB  51000 

430  FLAGS%  =  NUML%  :  GOSUB  50000 
440  FOR  Y%  =  1  TO  100  :  NEXT 
450  GOSUB  51000 

460  FLAGS%  =  SCRL%  :  GOSUB  50000 
470  FOR  Y%  =  1  TO  100  :  NEXT 
480  GOSUB  51000 
490  NEXT 

500  FLAGS%  =  SCRL%  OR  NUML%  OR  CAPL% 

510  FOR  X%  =  1  TO  10 
520  GOSUB  50000 
530  FOR  Y%  =  1  TO  400  :  NEXT 
540  GOSUB  51000 
550  FOR  Y%  =  1  TO  400  :  NEXT 
560  NEXT 

570  PRINT  "That's  all." 

580  END 
590  ' 

50000  '**********•*******★***★*★★***★**★★****★*★*********★********* 
50010  '*  set  one  or  more  of  the  flags  in  the  BIOS  keyboard  status 
50020  •* - 


•the  SCROLL  LOCK  flag 
•the  NUM  LOCK  flag 
•the  CAPS  LOCK  flag 
•run  through  the  loop  10  times 
•set  CAPS  LOCK 
•delay  loop 
•CAPS  LOCK  off  again 
•set  NUM  LOCK 
•delay  loop 
•NUM  LOCK  off  again 
•set  SCROLL  LOCK 
•delay  loop 
•SCROLL  LOCK  off  again 

•manipulate  all  three  flags 
•run  through  loop  10  times 
•set  all  three  flags 
•delay  loop 
•clear  all  flags  again 
•delay  loop 


50030 

50040 

50050 

50060 

50070 

50080 

50090 

50100 

50110 

50120 

50130 

50140 

50150 

51000 

51010 

51020 


'*  Input  :  FLAGS%  =  the  flags  to  be  set  *' 
'*  Output  :  none  *• 
•*  Info  :  the  variable  Z%  is  used  as^a  dummy  variable  *• 

•  ★★★**★★*★★★***★**★***  ********i^****************t^***  *★*★******★*★*• 


DEF  SEG  »  &H40 

POKE  &H17,  PEEK(&H17)  OR  FLAGS% 
INTR%  *  iH16 
AH%  =  1 
DEF  SEG 


CALL  lA (INTR%, AH%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%, Z%) 


•set  BIOS  variable  segment 
•set  the  flags 
•call  BIOS  keyboard  interrupt 
•function  1:  character  ready? 
•switch  back  to  the  GW  segment 


RETURN 


•back  to  the  caller 


•*  clear  one  or  more  the  flags  in  the  BIOS  keyboard  status 
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Pascal 


51030 

51040 

51050 

51060 

51070 

51080 

51090 

51100 

51110 

51120 

51130 

51140 

51150 

60000 

60010 

60020 

60030 

60040 

60050 

60060 

60070 

60080 

60090 

60100 

60110 

60120 

60130 

60140 

60150 

60160 

60170 

60180 

60190 

60200 

60210 

60220 

60230 


'*  Input  :  FIAGS%  «  the  flags  to  be  cleared  ** 
'*  Output  :  none  ** 
'*  Info  :  the  variable  Z%  is  used  as  a  dummy  variable  *' 

I  ****** *********** ***************************************** ******* 


DEF  SEG  -  4H40  'set  BIOS  variable  segment 

POKE  &H17,  PEEK(«H17)  AND  NOT(FLAGS%)  'clear  the  flags 

INTR%  -  iH16  'call  the  BIOS  keyboard  interrupt 

AH%  «  1  'function  1:  character  ready? 

DEF  SEG  'switch  back  to  the  GW  segment 

CALL  lA (INTR%, AH%, Z%, Z%, Z%, Z%, Z%, Z%, Z%,  Z%,  Z%,  Z%,  Z%) 

RETURN  'back  to  the  caller 

****************************************************************** 

'*  initialize  the  routine  for  the  Interrupt  call 
•  * _ _ _ *  • 

'*  Input  ;  none 

'*  Output  :  lA  is  the  start  address  of  the  interupt  routine  *' 
•  **************************************************************** • 


IA=60000!  'start  address  of  the  routine  in  the  BASIC  segment 

DEF  SEG  'set  BASIC  segment 

RESTORE  60130 

FOR  1%  *  0  TO  160  :  READ  X%  :  POKE  IA+I%,X%  :  NEXT  'poke  routine 
RETURN  'back  to  the  caller 

DATA  85,139,236,  30,  6,139,118,  30,139,  4,232,140,  0,139,118 

DATA  12,139,  60,139,118,  8,139,  4,  61,255,255,117,  2,140,216 

DATA  142,192,139,118,  28,138,  36,139,118,  26,138,  4,139,118,  24 

DATA  138,  60,139,118,  22,138,  28,139,118,  20,138,  44,139,118,  18 
DATA  138,  12,139,118,  16,138,  52,139,118,  14,138,  20,139,,118,  10 
DATA  139,  52,  85,205,  33,  93,  86,156,139,118,  12,137,  60,139,118 

DATA  28,136,  36,139,118,  26,136,  4,139,118,  24,136,  60,139,118 

DATA  22,136,  28,139,118,  20,136,  44,139,118,  18,136,  12,139,118 

DATA  16,136,  52,139,118,  14,136,  20,139,118,  8,140,192,137,  4 

DATA  88,139,118,  6,137,  4,  88,139,118,  10,137,  4,  7,  31,  93 

DATA  202,  26,  0,  91,  46,136,  71,  66,233,108,255 


listing:  LEDP.PAS 


I**********************************************************************} 

{*  L  E  D  P  *} 


Description  :  sets  the  various  bits  in  the  BIOS  keyboard 


Author 
developed  on 
last  update 


status  byte  causing  the  LEDs  on  the  AT 
keyboard  to  turn  on. 


MICHAEL  TISCHER 

08/16/1988 

08/17/1988 


I**********************************************************************} 


program  LEDP; 

uses  CRT, 

{  bind 

in  the  CRT  unit 

DOS; 

{  bind 

in  the  DOS  unit 

const  SCRL  » 

16; 

{ 

Scroll  Lock  bit 

NUML  * 

32; 

{  Num  Lock  bit 

CAPL  = 

64; 

{  Caps  Lock  bit 

INS  = 

128; 

{  Insert  bit 

^**********************************************************************1 
{*  SETFLAG:  sets  one  the  flags  in  the  BIOS  keyboard  status  byte  *} 

{*  Input  :  the  flag  to  be  set  (see  constants) 

{*  Output  :  none  *1 

I  **********************************************************************  j 

procedure  SetFlag(Flag  :  byte); 
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var  BiosTSByte  :  byte  absolute  $0040 : $0017; {  BIOS  keyboard  status  byte  } 
Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 

begin 

BiosTSByte  BiosTSByte  or  Flag;  {  mask  out  the  corresponding  bit  } 
Regs. AH  :»  1;  {  function  no.:  character  ready?  } 

intr($16,  Regs);  {  call  BIOS  keyboard  interrupt  } 

end; 


^★************** ********************************************** *********} 
{*  CLRFLAG:  clears  one  of  the  flags  in  the  BIOS  keyboard  status  byte  *} 
Input  :  the  flag  to  be  cleared  (see  constants) 

{*  Output  :  none  *} 

^ ********************************************************************** ^ 

procedure  ClrFlag(Flag  :  byte) ; 

var  BiosTS^te  :  byte  absolute  $0040: $0017;  {  BIOS  keyb.  status  byte  } 

Regs  :  Registers;  {  processor  registers  for  interrupt  call  } 

begin 

BiosTSByte  :*  BiosTSByte  and  (  not  Flag  ) ;  {  mask  out  bit  } 

Regs. AH  :*  1;  {  function  no.:  character  ready?  ) 

intr($16,  Regs);  {  call  BIOS  keyboard  interrupt  } 

end; 

I ********************************************************************** ^ 

{**  MAIN  PROGRAM  **} 

I  **★  ************************ 

var  counter  :  integer; 
begin 

writeln ( 'LEDP  -  (c)  1988  by  Michael  Tischer'); 

writeln  (#13, #10,  'Watch  the  LEDs  on  your  keyboard!'); 

for  counter:*!  to  10  do  {  run  through  the  loop  10  times  } 

begin 

SetFlag(  CAPL) ; 

Delay (  100  ); 

ClrFlag(  CAPL  ); 

SetFlag(  NUML) ; 

Delay (  100  ) ; 

ClrFlag(  NUML  ); 

SetFlag(  SCRL) ; 

Delay (  100  ); 

ClrFlag(  SCRL  ); 
end; 

for  counter:*!  to  10  do 
begin 

SetFlag(CAPL  or  SCRL  or  NUML) ; 

Delay (  200  ); 

ClrFlag(CAPL  or  SCRL  or  NUML) ; 

Delay (  200  ); 
end; 

end. 


{  turn  on  CAPS  } 
{  wait  100  milliseconds  } 
{  turn  CAPS  off  again  } 
{  turn  on  NUM  } 
{  wait  100  milliseconds  } 
{  turn  NUM  off  again  } 
{  turn  SCROLL  LOCK  off  } 
{  wait  100  milliseconds  } 
{  turn  SCROLL  LOCK  off  again  } 


{  run  through  loop  10  times  } 

{  all  three  flags  on  } 
{  wait  200  milliseconds  } 
{  all  flags  off  again  } 
(  wait  200  milliseconds  ) 
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C  listing:  LEDC.C 


/****★****★***★****★******************************★********************/ 
/*  L  E  D  C  */ 

/*  Description  :  Sets  the  various  bits  in  the  BIOS  keyboard  */ 

/*  flag/  causing  the  LEDs  on  the  AT  keyboard  to  */ 

/*  flash.  */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  developed  on  :  22.08.1988  */ 

/*  last  update  ;  22.08.1988  */ 

/*  (MICROSOFT  C)  */ 

/*  creation  :  CL  /AS  LEDC.C  */ 

/*  call  :  LEDC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  creation  :  via  the  command  COMPILE  /  MAKE  */ 

/★★★★★*★★**•*★★****************************************************★★***/ 

/★==  Include  files 

♦include  <dos.h> 

/*==*  Macros 

♦Ifndef  MK_FP  /*  was  MK_FP  already  defined?  */ 


♦define  MK_FP (seg,  ofs)  ((void  far  *)  ((unsigned  long)  (seg) «16| (ofs) ) ) 
♦endif 


/*==  Constants 


=*/ 


♦define  SCRL  16 
♦define  NUML  32 
♦define  CAPL  64 
♦define  INS  128 


/*  Scroll  Lock  bit  */ 
/*  Num  Lock  bit  */ 
/*  Caps  Lock  bit  */ 
/*  Insert  bit  */ 


/* —  BIOS_KBF  creates  a  pointer  to  the  BIOS  keyboard  flag - */ 

♦define  BIOS_KBF  ((unsigned  far  *)  MK_FP(0x40,  0x17)) 

/*****★★★*★**★**★****★★**★*****★*★★***★★****★★**★****★★**★**★★★*★★★★★★*★ 

*  Function  :  D  E  L  A  Y  * 

*  _ — _ * 

*  Description  ;  Waits  a  certain  length  of  time.  * 

*  Input  parameters  :  PAUSE  =  the  number  of  milliseconds  to  wait.  * 

*  Return  value  :  none  * 

*  Info  :  Since  this  function  uses  the  BIOS  timer  for  time  * 

*  measurement,  the  accuracy  is  limited  to  about  * 

*  1/60  of  a  second.  * 

******************* *★******★****★★**★★★***★★*****★★*★*******★***** ★***★/ 


void  delay (  unsigned  pause  ) 

( 

long  timer;  /*  stores  the  timer  value  to  be  reached  */ 

union  REGS  inregs,  /*  stores  the  processor  registers  */ 

outregs;  /*  INREGS  before,  OUTREGS  after  the  intr  call  */ 


inregs.h.ah  =0; 

int86(0xla,  &lnregs,  ioutregs) ; 

/*-  calculate  the  target  time  value 
/*-  value  has  been  reached. 


/*  ftn.  no.:  read  timer  */ 
/*  call  BIOS  timer  interrupt  */ 

and  check  to  see  if  this  - */ 

- */ 


timer  =*  outregs. x.dx  +  ((long)  outregs. x.cx  «  16)  + 

(pause  *  18  +  ((pause  «  1)  /  10) )  /  1000; 
do  /*  polling  loop  */ 

int86(0xla,  iinregs,  fioutregs) ;  /*  read  timer  again  */ 
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while  ( (outregs.x.dx  +  ((long)  outregs.x.cx  «  16))  <»  timer); 

} 

★★★**★★*★★★*★★★******★★★*★★★**★*★*★****★★*★★★★*★**★*★**★* ★★**** 

*  Function  :SET__FLAG  * 

★  * _ _ _ _ _ _ _ 

*  Description  :  Sets  individual  bits  or  flags  in  the  BIOS  * 

*  keyboard  flag.  * 

*  Input  parameters  :  FLAG  *  the  bits  or  flags  to  be  set  * 

*  Return  value  :  none  * 

★★*★★★★*★★*★*★★*★★★★★★★*★★★**★★*★*★★*★★★★*★★***★★*★*★★*★**★*★**★**★*★★★/ 


void  set_flag(  unsigned  flag  ) 

( 

union  REGS  regs;  /*  stores  the  processor  registers  */ 

*BIOS_KBF  1“  flag;  /*  set  the  specified  bits  in  the  keyboard  flag  */ 
regs. h. ah  =»  1;  /*  ftn.  no.:  character  present?  */ 

int86(0xl6,  &regs,  &regs);  /*  call  BIOS  keyboard  interrupt  */ 

) 

/★★★★*★★★★*★**★★★**★*★★****★**★*★★★★**★*★*★★*******★★★****★★***★**★*★★★★ 

*  Function  :CLR_FLAG  * 

** _ ★★ 

*  Description  :  Clears  individual  bits  or  flags  in  the  BIOS  * 

*  keyboard  flag.  * 

*  Input  parameters  :  FLAG  =  the  bits  or  flags  to  be  cleared  * 

*  Return  value  :  none  * 

*★**★*  ★★*★★★  **★★«**  Ik-*  ***★★*  ★★***★  ★★★*★★*  ★★*★★★**  ★★*★*★★*★*★**★★***  *★***/ 


void  clr_flag(  unsigned  flag  ) 

{ 

union  REGS  regs;  /*  stores  the  processor  registers  */ 

*BIOS_KBF  &-  ~flag;  /*  mask  out  bits  in  the  BIOS  keyb.  flag  */ 

regs. h. ah  -  1;  /*  ftn.  no.;  character  present?  */ 

int86(0xl6^  &regs,  &regs) ;  /*  call  BIOS  keyboard  interrupt  */ 

} 


/**********************************************************************/ 
/**  MAIN  PROGRAM  **/ 

/*********************  It** ********************************************** / 

void  mainO 
{ 

unsigned  i;  /*  loop  counter*/ 

printf (-LEDP  -  (c)  1988  by  Michael  Tischer\n\n*); 

printf ("Watch  the  LEDs  on  your  keyboard! Xn") ; 


for  (1*0;  i<10;  ++i) 

{ 

set_flag(  CAPL  ); 
delay (  100  ); 
clr_flag(  CAPL  ); 
set_flag(  NUML)  ; 
delay (  100  ); 
clr_flag(  NUML  ); 
set _f lag (  SCRL) ; 
delay (  100  )  ; 
clr_f lag (  SCRL  ) ; 

} 

for  (i=0;  i<10;  ++i) 

{ 

set_flag  (CAPL  |  SCRL  |  NUML)  ; 
delay (  200  ); 

clr_f lag (CAPL  |  SCRL  |  NUML) ; 
delay (  200  ); 

} 

} 


/*  run  through  the  loop  10  times  */ 

/*  turn  CAPS  on  */ 
/*  wait  100  milliseconds  */ 
/*  turn  CAPS  off  again  */ 
/*  turn  on  NUM  */ 
/*  wait  100  milliseconds  */ 
/*  turn  NUM  off  again  */ 
/*  turn  on  SCROLL  LOCK  */ 
/*  wait  100  milliseconds  */ 
/*  turn  SCROLL  LOCK  off  again  */ 


/*  run  through  the  loop  10  times  */ 

/*  all  three  flags  on  */ 
/*  wait  200  milliseconds  */ 
/*  all  flags  off  again  */ 
/*  wait  200  milliseconds  */ 
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When  the  IBM  PC  was  being  developed  in  1980  its  capabilities  were  quite 
advanced  for  its  time.  This  was  also  true  of  the  size  of  its  main  memory.  The 
maximum  size  of  640K  seemed  so  large  at  the  time  that  no  one  could  imagine 
what  a  user  would  do  with  so  much  memory.  Thus  the  first  PCs  were  equipped 
with  64K,  then  128K,  and  later  256K  of  memory.  But  today  memory  requirements 
are  much  greater  and  the  standard  amount  of  RAM  for  PCs,  and  especially  ATs, 
has  grown  to  the  full  640K. 

As  we  enter  the  age  of  the  80386  microprocessor,  with  the  introduction  of  graphic 
user  interfaces  and  multitasking  operating  systems  (Windows®,  OS/2®),  640K 
will  soon  no  longer  be  enough  to  make  full  use  of  the  c^abilities  of  the  PC.  But 
we  have  reached  a  boundary  that  cannot  be  crossed  by  just  adding  more  memory 
chips  to  the  computer.  A  normal  PC  or  XT  is  limited  to  640K  and  an  AT  to  16 
megabytes.  The  16  meg  is  only  available  in  the  protected  mode  of  the  80286 
processor,  and  is  inaccessible  to  normal  DOS  applications. 

Adding  memory 

To  provide  a  way  around  this  problem,  some  leading  PC  firms  got  together  several 
years  ago  and  devised  a  way  to  add  more  memory  to  PCs,  XTs  and  ATs  that  could 
also  be  accessed  under  DOS.  These  companies  were  Lotus  (the  developers  of  Lotus 
1-2-3),  Intel  (manufacturer  of  PC  processors)  and  Microsoft  (developers  of  MS- 
DOS  and  OS/2).  They  developed  a  standard  known  as  the  LIM  standard,  after  the 
first  letters  of  the  company  names. 

This  standard  allows  up  to  8  megabytes  to  be  added  to  a  PC  on  an  expansion  card. 
Only  64K  of  this  8  megabytes  is  visible  in  the  1  megabyte  address  range  of  the 
8088  processor,  in  a  window  called  the  page  frame.  Memory  installed  in  this 
manner  is  called  expanded  memory,  and  should  not  be  confused  with  the  extended 
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memory  which  ranges  beyond  1  megabyte  on  an  AT.  The  whole  system  is  referred 
to  as  the  expanded  memory  system,  or  EMS  for  short. 

1  megabyte 

Main  memory  EMS  memory 


EMS  memory  access  (UM  standard)  using  a  window 

There  is  always  at  least  64K  in  the  1  megabyte  address  space  of  the  PC  which  is 
not  used  for  main  memory,  BIOS,  video  RAM,  or  other  system  expansions,  so  the 
EMS  developers  decided  to  use  this  as  a  window  into  the  EMS  memory.  Usually 
this  window  is  at  segment  address  DOOOH,  but  the  EMS  hardware  allows  it  to  be 
changed. 

Since  this  window  is  under  the  1  megabyte  memory  limit,  it  can  be  accessed  with 
normal  assembly  language  instructions,  similar  to  the  way  the  video  RAM  is 
accessed.  Both  read  and  write  accesses  are  possible.  We  will  look  at  concrete 
examples  of  these  accesses  later  on  in  this  chapter. 
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Page  frame  division 

The  whole  procedure  is  somewhat  refined  by  the  fact  that  the  page  frame  is  further 
divided  into  16K  pages.  This  allows  the  programmer  to  access  four  completely 
different,  and  p^aps  widely  separated,  pages  from  the  EMS  memory. 

The  regist^s  on  the  EMS  card  allow  the  programmer  to  set  which  pages  of  the 
EMS  memory  will  be  visible  in  the  page  frame.  The  address  lines  on  the  EMS 
card  are  programmed  so  that  the  EMS  pages  are  mapped  into  the  page  frmne  and 
appeal  in  the  8088*s  address  space.  This  process  is  known  as  bank-switching. 

In  addition  to  the  hardware,  the  EMS  also  includes  a  software  int^face  which 
handles  programming  the  EMS  registers  and  oth^  memory  management  tasks.  It 
is  called  the  EMM  (Expanded  Memory  Manage)  and  gives  you  a  standard  interface 
which  you  can  use  to  access  the  EMS  cards  of  different  manufacture.  This  also 
applies  for  the  extended  EMS  standard  (EEMS)  developed  by  AST  Research, 
Quadram,  and  Ashton-Tate,  which  goes  far  beyond  the  LIM  standard. 

The  EMM 

Similar  to  the  DOS  interrupt  21H,  which  provides  a  standard  interface  to  the 
operating  system  functions,  the  EMM  functions  can  be  called  through  interrupt 
67H.  Before  a  program  tries  to  use  EMS  memory  and  the  corresponding  EMM,  it 
should  first  check  to  make  sure  that  an  EMS  is  installed.  If  it  does  not  do  this  and 
there  is  no  EMM,  the  results  of  a  call  to  interrupt  67H  are  completely 
unpredictable.  Maybe  it  just  won’t  work;  maybe  the  system  will  crash. 

To  prevent  this,  a  program  which  uses  the  EMS  should  first  check  to  make  sure  it 
exists.  To  do  this  we  can  use  the  fact  that  the  EMM  is  bound  into  the  system  as  a 
normal  device  driver  when  the  computer  is  booted.  As  such,  it  naturally  has  a 
driver  header  which  precedes  it  in  memory  and  defines  its  structure  for  DOS.  The 
name  of  the  driver  is  found  at  address  10  in  the  driver  header.  The  LIM  standard 
prescribes  that  this  name  must  be  EMMXXXXO.  The  example  programs  at  the  end 
of  this  chapter  test  for  this  name  by  first  determining  the  segment  address  of  the 
interrupt  handler  for  interrupt  67H.  If  the  EMM  is  installed,  the  segment  address 
points  to  the  segment  into  which  the  EMMXXXXO  device  driver  was  loaded. 
Since  the  driver  header  is  at  offset  address  0  relative  to  the  start  of  this  segment,  we 
just  compare  the  memory  locations  starting  at  10  with  the  name  EMMXXXXO  to 
see  if  the  EMS  memory  and  the  corresponding  EMM  are  installed. 

Once  this  is  verified,  access  to  this  memory  requires  just  three  stq)s: 

1.)  Just  as  conventional  memory  must  be  allocated  with  a  DOS  function,  a 
program  must  first  allocate  a  certain  numb^  of  EMS  pages  for  itself  from 
the  EMM.  The  number  of  pages  to  be  allocated  depends  on  both  the 
memory  requirements  of  the  program  and  how  much  EMS  memory  is 
available. 
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2. )  If  the  desired  number  of  pages  were  successfully  allocated,  the  q)ecified 

pages  must  first  be  loaded  into  one  of  the  four  pages  of  the  page  frame  so 
that  data  can  be  written  into  them  or  read  from  them.  This  results  in  a 
mapping  between  one  of  the  allocated  pages  and  one  of  the  four  physical 
pages  within  the  page  frame. 

3. )  When  the  program  is  ended  or  it  is  done  using  the  EMS  storage,  the 

allocated  pages  should  be  released  again.  If  this  is  not  done,  the  allocated 
pages  will  still  be  owned  by  the  program  (even  after  it  aids)  and  cannot 
be  givoi  to  other  programs. 

As  with  DOS  intOTupt  21H,  the  function  number  of  an  EMM  call  must  be  loaded 
into  the  AH  register  before  the  intorupt  call.  In  contrast  to  the  DOS  functions,  the 
function  numba  does  not  correspond  directly  to  the  value  in  the  AH  register  and 
you  must  add  3FH  to  the  function  number.  Thus  for  a  call  to  function  2H  you 
would  have  to  load  the  value  3FH  2H  or  41H  into  the  AH  register.  After  the 
function  call  this  register  contains  the  error  status  of  the  function.  The  value  0 
signals  that  the  function  was  executed  successfully,  while  values  greater  than  or 
equal  to  80H  indicate  an  error. 

About  errors 

You  can  get  the  oror  codes  from  the  error  descriptions  in  the  Appendices,  but  you 
should  be  aware  of  one  particular  error.  If  the  value  S4H  is  in  the  AH  register  after 
a  call  to  EMM  interrupt  67H,  it  means  that  an  invalid  function  numba  was  passed 
in  the  AH  register. 

The  following  functions  are  required  for  a  transient  program  to  access  the  EMS 
memory: 


Function 

Task 

OlH 

Get  EMM  status 

02H 

Get  segment  address  of  the  page  frame 

03H 

Get  number  of  pages 

04H 

Allocate  EMS  pages 

OSH 

Set  mapping 

06H 

Release  EMS  pages 

To  guarantee  proper  operation  of  the  EMS  hardware  and  the  EMM,  you  should 
check  the  EMM  status  before  allocating  EMS  memory.  This  is  done  with  functicm 
OlH,  which  requires  no  parametos  beside  the  function  number  in  the  AH  regista. 
If  it  returns  the  value  0  in  the  AH  register,  then  everything  is  OK  and  you  can  start 
working  with  the  EMS  memory. 

Limits  to  EMS  allocation 

Naturally  the  numbor  of  allocatable  EMS  pages  is  limited  by  the  number  of  free 
pages.  Thus  you  should  ensure  that  the  memory  requirements  of  the  program  do 
not  exceed  the  available  memory.  Here  we  can  use  function  03H,  which  returns  the 
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number  of  free  EMS  pages.  This  function  requires  no  parameters  beside  the 
function  numba  and  returns  the  numbo'  of  unallocated  pages  in  the  BX  regist^.  It 
also  returns  the  total  numbo'  of  installed  EMS  pages  in  the  DX  registo'. 

If  enough  EMS  memory  exists  for  our  program,  or  if  the  memory  requirements  are 
adapted  to  the  available  memory,  we  can  then  allocate  the  memtvy.  Function  04H 
must  be  passed  the  number  of  pages  to  be  allocated  in  the  BX  register.  If  the 
requested  numba  of  pages  were  successfully  allocated  (AH  registo’  contains  0  afte* 
the  function  call),  the  caller  will  find  a  handle  to  the  allocated  pages  in  the  BX 
regista.  This  handle  must  be  used  to  access  the  allocated  pages  and  identifies  the 
caller  to  the  EMM.  This  handle  must  be  saved  by  the  caller  and  losing  it  means 
not  only  that  the  allocated  pages  cannot  be  accessed,  they  can  also  no  longer  be 
released.  This  function  can  be  called  multiple  times  by  a  program  to  allocate 
multiple  logical  page  blocks. 

Once  we  have  the  page  handle  we  can  start  accessing  the  pages.  The  handle  is 
passed  to  the  appropriate  functions  in  the  DX  register.  This  also  applies  to 
function  OSH,  which  maps  a  logical  page  to  one  of  the  four  physical  pages  of  the 
page  frame.  The  number  of  the  logical  page  is  passed  in  the  BX  register  and  the 
physical  page  number  in  the  AL  register.  Note  that  both  specifications  start  at 
zero.  If  you  have  allocated  IS  pages,  then  the  numb^s  of  the  logical  pages  run 
from  zero  to  14. 

Once  the  impropriate  page  is  in  the  page  frame,  it  can  be  accessed  just  like  normal 
memcHy .  Tbe  offset  address  of  the  start-of-page  is  calculated  from  the  {diysical  page 
number,  but  the  corresponding  segment  address  must  be  detmnined  with  an  EMM 
function.  Since  this  address  does  not  change  while  working  with  the  EMS 
memcMy,  you  can  read  it  once  at  the  beginning  of  the  program  and  then  save  it  in  a 
variable.  Function  02H  returns  the  segment  address  of  the  page  frame  in  the  BX 
register. 

When  you  are  done  using  the  EMS,  be  sure  to  return  the  allocated  pages  to  the 
EMM.  All  you  have  to  do  is  pass  the  page  handle  to  function  06H. 


In  addition  to  these  six  functions,  which  a  normal  program  can  use  to  access  EMS 
memory,  there  are  six  more  functions  which  can  be  useful  under  certain 
circumstances.  These  are  the  following: 


Function 

Task 

07H 

Get  EMM  version  number 

OSH 

Save  current  mapping 

09H 

Reset  saved  mapping 

OCH 

Get  number  of  EMM  handles 

ODH 

Get  the  number  of  pages  allocated  to  a  handle 

OEH 

Get  all  handles  and  numbers  of  allocated  pages 
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Version  numbers 

Reading  the  EMM  version  number  is  of  interest  because  the  LIM  standard  has 
changed  somewhat  since  it  was  introduced.  Some  functions  are  no  longer  supported 
and  new  functions  have  been  added.  Tbe  functions  fuesented  hoe  are  from  Version 
3.2,  which  has  now  been  suposeded  by  version  4.0.  Version  3.2  represents  a  good 
compromise  not  only  because  is  it  very  widely  used,  but  because  it  is  also 
completely  compatible  with  Version  4.0.  If  you  don't  want  to  suppcnt  earlier  » 
later  EMS  versions  in  your  program,  you  should  check  the  version  numbo*  at  the 
start  of  the  program.  The  vo^on  numbo'  will  be  returned  in  the  AL  regist^  after  a 
call  to  function  07H.  It  is  encoded  as  a  BCD  numbo*. 

Functions  OSH  and  09H  are  imptulant  for  TSR  programs  which  want  to  use  the 
EMS  memory  for  their  own  purposes.  When  a  TSR  program  interrupts  a  transient 
program  and  places  itself  in  the  foreground,  it  must  take  into  account  the  fact  that 
the  interrupted  program  may  have  been  using  EMS  memory  and  had  created  a 
certain  mapping.  Since  this  mapping  must  not  be  changed  when  returning  to  the 
interrupted  program,  it  must  be  saved  when  the  TSR  is  activated  and  thra  restored 
when  the  TSR  exits.  Function  OSH  saves  the  current  EMM  mapping  and  function 
09H  resets  the  saved  status.  Both  functions  must  be  passed  the  handle  of  the 
function.  In  this  case  it  is  the  handle  of  the  TSR  program,  not  the  handle  of  the 
intmupted  program. 

The  last  three  functions  are  only  important  for  the  memory  manager  and  will  not 
be  discussed  here.  More  information  can  be  found  in  the  appendix  in  the  EMM 
function  descriptions. 

Demonstration  programs 

The  following  pages  contain  two  programs,  one  written  in  Pascal  and  one  in  C, 
which  illustrate  how  to  use  EMS  memwy.  There  is  no  assembly  language 
program  since,  in  principle,  calls  to  the  EMM  fungtions  involve  just  loading 
variables  and  constants  into  registers  and  calling  the  EMM  intorupt  67H.  Using 
the  information  in  the  Appendices,  it  should  be  easy  to  write  an  assembly 
language  program  which  uses  the  EMS.  There  is  no  BASIC  program  because 
EMS  memory  is  intended  to  be  used  with  complex  and  mem(»y-intensive 
applications  for  which  BASIC  (or  at  least  GW-B ASIC)  is  not  suited. 

The  two  programs  are  almost  identical,  so  we  will  limit  ourselves  to  a  discussion 
of  the  basic  program  structure.  The  programs  offer  a  number  of  functions  and 
procedures  which  can  be  used  to  access  the  various  EMM  functions.  Both 
programs  also  cmtain  a  function  called  EMS_INST  (or  Emsinst)  which  determines 
if  an  EMM  is  installed.  In  Pascal  we  have  a  problem  because  a  pointer  has  to  be 
loaded  with  an  address  which  consists  of  separate  segment  and  offset  addresses. 
Since  this  is  not  possible  in  Pascal,  there  is  an  INLINE  procedure  called  MK_FP 
which  (like  the  C  macro  of  the  same  name)  combines  a  segment  and  an  offset 
address  into  a  (FAR)  pointer.  The  fact  that  this  is  a  FAR  pointer  is  important 
because  the  page  frame  is  not  in  the  program's  data  segment  and  thus  cannot  be 
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addressed  via  the  DS  register.  This  is  not  a  problem  in  Tuibo  Pascal  because  the 
code  is  genoated  to  w(Mk  with  FAR  data  pointers.  In  C  we  have  to  make  sure  that 
the  program  is  compiled  in  a  mem(My  model  which  uses  FAR  pointers  for  data. 
This  occurs  in  compact,  large,  and  huge  models. 

The  main  program  firsts  tests  to  see  if  EMM  is  present  and  then  uses  various 
functions  to  obtain  status  information  about  the  EMS  memmy,  which  it  displays 
on  the  screen.  Then  a  page  is  allocated  and  mapped  to  the  first  page  (page  0)  of  die 
page  frame.  The  current  contents  of  the  video  RAM  are  copied  into  this  page  and 
the  video  RAM  is  then  erased. 


Aftn  the  copy  procedure,  a  message  is  displayed  for  the  uso*  and  the  program  waits 
fw  a  key  to  be  pressed.  Then  it  copies  the  old  screen  contents  back  to  video  RAM 
from  page  0  of  the  page  frame  and  the  program  ends. 


This  program  shows  that  the  contents  of  a  page  in  the  page  frame  can  be  treated 
just  like  (Hdinary  data.  After  you  have  creat^  a  points'  to  the  corresponding  page 
you  can  manipulate  the  data  on  this  page,  including  complex  objects  like 
structures  and  arrays,  just  like  any  other  data.  It  is  important  to  make  sure  that 
your  objects  fit  on  one  page  or  that  you  do  not  forget  to  change  pages  or  load  a 
new  page  into  the  page  fr'ame  to  access  larger  objects. 


C  listing:  EMMC.C 

/**********************************************************★***********/ 


’* 

E  M  M  C 

*^ 

'* 

Description 

:  a  collection  of  functions  for  using  EMS 

* 

’* 

storage  (expanded  memory) . 

* 

’* 

Author 

:  MICHAEL  TISCHER 

* 

* 

developed  on 

:  08/30/1988 

* 

’* 

*  _ 

last  update 

:  08/30/1988 

* 

* 

(MICROSOFT  C) 

* 

’* 

creation 

:  CL  /AC  EMMC.C 

* 

’* 

’★ _ 

call 

:  EMMC 

* 

’* 

(BORLAND  TURBO  C) 

* 

creation 

:  via  the  RUN  command  in  the  menu  line 

* 

(no  project  file) 

* 

’* 

Info 

:  Note  that  the  Compact  memory  model  must  be 

* 

'* 

selected  via  the  compiler  model  menu  option. 

* 

/****************it* ************************************** **************/ 

/♦*=*=  Include  files  »»»**—«»*/ 


♦include  <dos.h> 

♦include  <stdllb.h> 

♦include  <strlng.h> 

/★«*  Typedefs 

typedef  unsigned  char  BYTE;  /*  build  ourselves  a  byte  */ 

typedef  unsigned  int  WORD; 

typedef  BYTE  BOOL;  /*  like  BOOLEAN  in  Pascal  */ 
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/* —  MK_FP  creates  a  FAR  pointer  out  of  segment  and  offset  addresses  -*/ 

#lfndef  MK_FP  /*  is  MK_FP  defined  yet?  */ 

ideflne  MK_FP(seg,  ofs)  ((void  far  *)  ((unsigned  long)  (seg)  «16|  (ofs) ) ) 
iendlf 

/* —  PAGE_ADR  returns  a  pointer  to  the  physical  page  X  within  the  - */ 

/* —  page  frame  of  the  EMS  memory.  - */ 

ideflne  PAGE_ADR(x)  ((void  *)  MK_FP (ems_frame__seg()  +  ((x)  «  10),  0)) 

/*“  Constants 

ideflne  TRUE  1  /*  constants  for  working  with  BOOL  */ 

ideflne  FALSE  0 

ideflne  EMS__INT  0x67  /*  interrupt  number  for  access  to  the  EMM  */ 

ideflne  EMS_ERR  -1  /*  returned  on  error  */ 

BYTE  emm_ec;  /*  the  EMM  error  codes  are  placed  here  */ 

/****************ii***1t  ****************************************  ********** 

*  Function  :EMS_INST  * 

** - - _ ** 

*  Description  :  Determines  if  EMS  memory  and  the  associated  * 

*  EMS  driver  (EMM)  are  installed.  * 

*  Input  parameters  :  none  * 

*  Return  value  :  TRUE,  If  EMS  memory  installed,  else  FALSE  * 

************************************************************ ***********^ 


BOOL  ems_lnst() 

{ 

static  char  emm_name[]  «  {  'E',  'M',  'M',  'X',  'X',  'X',  'X',  'O'  ); 
union  REGS  regs;  /*  processor  registers  for  Interrupt  call  */ 

struct  SREGS  sregs;  /*  segment  registers  for  the  interrupt  call  */ 
BYTE  1;  /*  loop  counter  */ 

char  *emm_lnspect7  /*  pointer  to  the  name  In  the  interrupt  handler  */ 

/* —  construct  pointer  to  name  in  the  header  of  a  switch  driver  - */ 


regs. X. ax  »  0x3567;  /*  ftn.  no.:  get  interrupt  vector  0x67  */ 

intdosx (firegs,  firegs,  4 sregs ) ;  /*  call  DOS  interrupt  0x21  */ 

emm_lnspect  =  (char  *)  MK_FP (sregs.es,  10);  /*  construct  pointer  */ 

/* —  search  for  the  name  of  the  EMS  driver - */ 

for (1=0;  i<sizeof  emm_name  &&  * (emm_inspect++) -=emm_name[l++] ;  ) 

f 

return (  1  ==  slzeof  emm_name  );  /*  TRUE  if  name  found  */ 

} 

/*********************************************************************** 

*  Function  :EMS_NUM_PAGE  * 

*★ - - - ★* 

*  Output  :  Determines  the  total  number  of  EMS  pages  * 

*  Input  parameters  :  none  * 

*  Return  value  :  EMS_ERR  on  error,  else  the  number  of  EMS  pages  * 

********************************************************************* **^ 


1 nt  ems_num_page ( ) 

{ 

union  REGS  regs;  /*  processor  registers  for  interrupt  call  */ 


regs. h. ah  =  0x42; 
int86 (EMS_INT,  &regs,  &regs) ; 
if  (emm_ec  =  regs. h. ah) 
return  (EMS_ERR)  ; 
else 


/*  ftn.  no.:  get  number  of  pages  */ 
/*  call  EMM  */ 
/*  did  an  error  occur?  */ 
/*  yes,  display  error  */ 
/*  no  error  */ 
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return (  regs.x.dx  }; 

} 


/*  return  total  number  of  pages  */ 


/*****  *-k*  *************************  1tit**itit***1t****-k*-k  ************  ********* 

*  Function  :EMS_FREE_PAGE  * 

** _ _ _ ** 

*  Description  :  Returns  the  number  of  free  EMS  pages,  * 

*  Input  parameters  :  none  * 

*  Return  value  :  EMS^ERR  on  error,  else  the  number  of  free  EMS  * 

*  pages .  * 

***********************************************************************/ 


/*  processor  registers  for  Interrupt  call  */ 


Int  €ms_free_page  () 

{ 

union  REGS  regs; 

regs.h.ah  -  0x42; 
int 8 6  (EMS_INT,  &regs,  &regs} ; 
if  (enin_ec  -  regs.h.ah) 
return  (EMS_ERR)  ; 
else 

return (  regs.x.bx  ); 


/*  ftn.  no.:  get  number  of  pages  */ 
/*  call  EMM  */ 
/*  did  an  error  occur?  */ 
/*  yes,  display  error  */ 
/*  no  error  */ 
/*  return  number  of  free  pages  */ 


/*********************************************************************** 

*  Function  :EMS_FRAME_SEG  * 

★  *_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ *  * 

*  Description  :  Determines  the  segment  address  of  the  EMS  page  * 

*  frames .  * 

*  Input  parameters  :  none  * 

*  Return  value  :  EMS_ERR  on  error,  else  the  segment  address  of  * 

*  the  page  frame.  * 

***********************************************************************/ 


WORD  ems_frame_seg() 

{ 

union  REGS  regs;  /*  processor  registers  for  interrupt  call  */ 


regs.h.ah  -  0x41;  /*  ftn.  no.: 

Int86 (EMS_INT,  &regs,  &regs) ; 
if  (enin_ec  -  regs.h.ah) 
return  (EMS_ERR) ; 
else 

return (  regs.x.bx  ); 


get  segment  addr  page  frame  */ 
/*  call  EMM  */ 
/*  did  an  error  occur?  */ 
/*  yes,  display  error  */ 
/*  no  error  */ 
/*  return  segtment  address  */ 


/*********************************************************************** 

*  Function  :EMS_ALLOC  * 

** _ _ _ _ _ ** 

*  Description  :  Allocates  the  specified  number  of  pages  and  * 

*  returns  a  handle  for  accessing  these  pages.  * 

*  Input  parameters  :  PAGES  :  the  number  of  pages  to  be  allocated  * 

*  (each  16  KByte)  * 

*  Retum-Wert  :  EMS_ERR  on  error,  else  the  EMS  handle.  * 

**********************************  *i,  *1,1,1,  *******************************  y 


int  ems__alloc(int  pages) 

{ 

union  REGS  regs;  /*  processor  registers  for  Interrupt  call  */ 


regs.h.ah  -  0x43;  /*  ftn.  no.:  allocate  pages  */ 

regs.x.bx  -  pages;  /*  set  number  of  pages  to  be  allocated  */ 


lnt86 (EMS_INT,  &regs,  &regs) ; 
if  (enin_ec  -  regs.h.ah) 
return  (EMS_ERR)  ; 
else 

return (regs.x.dx  ); 


/*  call  EMM  */ 
/*  did  an  error  occur?  */ 
/*  yes,  display  error  */ 
/*  no  error  */ 
/*  return  EMS  handle  */ 


/*********************************************************************** 
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*  Function  :EMS_MAP  * 

** _ ** 

*  Description  :  Maps  one  of  the  allocated  pages  specified  * 

*  by  the  given  handle  onto  a  physical  page  in  the  * 

*  page  frame.  * 


*  Input  parameters  :  HANDLE:  the  handle  returned  by  EMS_ALLCX:  * 

*  LOGP  :  the  logical  page  (0  to  n-1)  * 

*  PHYSP  :  the  physical  page  (0  to  3)  * 

*  Retum-Wert  :  FALSE  on  error,  else  TRUE.  * 

**★★**★*★★****★*★***★****★★********★**★**★★***★★★***★*****★★***★★****★*/ 


BOOL  ems_map(int  handle,  int  logp,  BYTE  physp) 

{ 

union  REGS  regs;  /*  processor  registers  for  interrupt  call  */ 


regs.h.ah  »  0x44; 

regs.h.al  »  physp; 

regs.x.bx  »  logp; 

regs.x.dx  »  handle; 

int86 (EMS_INT,  &regs,  &regs) ; 

return  (!(enin_ec  «  regs.h.ah)); 

} 


/*  ftn.  no.:  set  mapping  */ 
/*  set  physical  page  */ 
/*  set  logical  page  */ 
/*  set  EMS  handle  */ 
/*  call  EMM  */ 


/*********************************************************************** 


*  Function  :EMS_FREE  * 

** _ ★* 

*  Description  :  Releases  the  memory  specified  by  the  handle.  * 

*  Input  parameters  :  HANDLE:  the  handle  returned  by  EMS_ALLOC  * 

*  Return  value  :  FALSE  on  error,  else  TRUE.  * 


********★**************************************************************/ 


BOOL  ems_free(int  handle) 

union  REGS  regs;  /*  processor  registers  for  interrupt  call  */ 

regs.h.ah  »  0x45;  /*  ftn.  no.:  release  pages  */ 

regs.x.dx  -  handle;  /*  set  EMS  handle  */ 

int86(EMS_INT,  &regs,  &regs) ;  /*  call  EMM  */ 

return  <!  (eitin_ec  -  regs.h.ah));/*  if  AH  contains  0,  everything’s  OK  */ 

} 


/★***************★* *★****★**★**★★★********★**********★***★*★*** **★**★**★ 


*  Function  :EMS_VERSION  * 

** _ ** 

*  Description  :  Determines  the  EMM  version  number.  * 

*  Input  parameters  :  none  * 

*  Return  value  :  EMS_ERR  on  error,  else  the  EMM  version  number  * 

*  Info  :  In  the  version  number,  10  stands  for  1.0,  11  for  * 

*  1.1,  34  for  3.4,  etc.  * 


************************************************ ★****★★** ★*************/ 

BYTE  ems_version() 

{ 

union  REGS  regs;  /*  processor  registers  for  interrupt  call  */ 

regs.h.ah  »  0x46;  /*  ftn.  no.:  get  E^f^  version  num.  */ 

int86 (EMS_INT,  &regs,  &regs) ;  /*  call  EMM  */ 

if  (eirm_ec  -  regs.h.ah)  /*  did  an  error  occur?  */ 

return <EMS_ERR) ;  /*  yes,  display  error  */ 

else  /*  no  error,  calculate  version  number  from  BCD  number  */ 

return (  (regs.h.al  &  15)  +  (regs.h.al  »  4)  *  10); 

} 


/********************* ************ ********* *********************** ****★★ 

*  Function  :EMS_SAVE_MAP  * 

** _ ** 

*  Description  :  Saves  the  mapping  between  the  logical  and  * 

*  physical  pages.  * 

*  Input  parameters  :  HANDLE:  the  handle  returned  by  EMS_ALLOC.  * 

*  Return  value  :  FALSE  on  error,  else  TRUE.  * 


60< 


Abacus 


13.  Expanded  Memory  Specification 


******************************* *★★★★★ f 

BCX}L  ems_save_map(int  handle) 

union  REGS  regs;  /*  processor  registers  for  interrupt  call  */ 

regs.h.ah  -  0x47;  /*  ftn.  no.:  save  mapping  */ 

regs.x.dx  -  handle;  /*  set  EMS  handle  */ 

int86 (EMS_INT,  &regs,  &regs) ;  /*  call  EMM  */ 

return  (!(eirm_ec  -  regs.h.ah));/*  if  AH  contains  0,  everything's  OK  */ 

} 


/■kit-k-kitifkifk-k-kifkifkititifkitifk-k-kiflfkitifkifkick-kifkitifkitickicifkifkifkifkifkifkifk-kifkick-k-k-k-k-k-k-k-k 


*  Function  :EMS_RESTORE_MAP  * 

** - - - .** 

*  Description  :  Restores  a  mapping  between  logical  and  physical  * 

*  pages  saved  with  EMS_SAVE_MAP .  * 


*  Input  parameters  :  HANDLE:  the  handle  returned  by  EMS_ALL0C  * 

*  Return  value  :  FALSE  on  error,  else  TRUE.  * 

*********************************************'**************************y 

BOOL  ems_restore_map (int  handle) 

{ 

union  REGS  regs;  /*  processor  registers  for  interrupt  call  */ 

regs.h.ah  -  0x48;  /*  ftn.  no.:  restore  mapping  */ 

regs.x.dx  »  handle;  /*  set  EMS  handle  */ 

int86 (EMS_INT,  firegs,  &regs) ;  /*  call  EMM  */ 

return  (!(einm_ec  »  regs.h.ah));/*  if  AH  contains  0,  wverything's  OK  */ 

} 


******  **************  ******  ********************************* 


*  Function  :PRINT_ERR  * 

** - - 


*  Description  ;  Prints  an  EMS  error  message  on  the  screen  and  * 

*  ends  the  program.  * 

*  Input  parameters  ;  none  * 

*  Return  value  :  none  * 

*  Info  :  This  function  may  only  be  called  if  an  error  * 

*  occurred  on  a  prior  call  to  the  EMM.  * 

****************************** *****************************************^ 


void  print_err() 

{ 

static  char  nid[]  =  "unidentifiable"; 
static  char  *err_vec[]  = 

{  "Error  in  the  EMS  driver  (EMM  destroyed) ", 

"Error  in  the  EMS  hardware", 
nid, 

"Illegal  EMM  handle", 

"EMS  function  called  does  not  exist", 

"No  more  EMS  handles  available", 

"Error  while  saving  or  restoring  the  mapping", 
"More  pages  requested  than  physically  present", 
"More  pages  requested  than  are  still  free", 
"Zero  pages  requested", 

"Logical  page  does  not  belong  to  handle", 
"Illegal  physical  page  number", 

"Mapping  storage  is  full", 

"The  mapping  has  already  been  saved", 

"Restored  mapping  without  saving  first" 

}; 


/* 

0x80 

*/ 

/* 

0x81 

*/ 

/* 

0x82 

*/ 

/* 

0x83 

*/ 

/* 

0x84 

*/ 

/* 

0x85 

*/ 

/* 

0x86 

*/ 

/* 

0x87 

*/ 

/* 

0x88 

*/ 

/* 

0x89 

*/ 

/* 

0x8A 

*/ 

/* 

0x8  B 

*/ 

/* 

0x8C 

*/ 

/* 

0x8D 

*/ 

printf ("\nError  in  access  to  EMS  memory! \n"); 

printf("  ...  %s\n",  (emm_ec<0x80  ||  emm_ec>0x8E)  ? 

nid  ;  err_vec[emm_ec-0x80] ) ; 

exit (  1  ) ;  /*  End  program  with  error  code  */ 

} 


/*************************************«*****«.**************************« 
*  Function  :  V  R  A  D  R  * 
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★  ★ _ _ _ _ _ ★  ★ 

*  Description  :  Returns  a  pointer  to  the  video  RAM.  * 

*  Input  parameters  :  none  * 

*  Return  value  ;  VOID  pointer  to  the  video  RAM.  * 

***********************************************************************/ 

void  *vr_adr() 

{ 

union  REGS  regs;  /*  processor  registers  for  Interrupt  call  */ 

regs.h.ah  -  OxOf;  /*  ftn.  no.;  get  video  mode  */ 

Int86(0xl0,  &regs,  &regs) ;  /*  call  BIOS  video  Interrupt  */ 

return  (  MK_FP  ( (regs.h.al— 7)  ?  OxbOOO  :  OxbSOO,  0)  ); 

} 

/**********************************************************************/ 
/**  MAIN  PROGRAM  **/ 

/**********************************************************************/ 


void  malnO 
{ 

Int  numpage, 
handle, 

1; 

WORD  pageseg  ; 
BYTE  emmver; 


/*  number  of  EMS  pages  */ 
/*  handle  to  access  to  the  EMS  memory  */ 
/*  loop  counter  */ 
/*  segment  address  of  the  page  frame  */ 
/*  EMM  version  number  */ 


prlntf(-EM<C  -  (c)  1988  by  MICHAEL  TISCHERXnXn") ; 

If  (  ems__lnst()  )  /*  Is  EMS  memory  Installed?  */ 


{  /*  yes  */ 

/* —  output  Information  about  the  EMS  memory - */ 


If  (  (enmver  «  ems_verslon() )  -=  EMS_ERR)  /*  get  version  num.  */ 

prlnt_err();  /*  error:  output  error  message  and  end  program  */ 

else  /*  no  error  */ 

prlntf  (••E^f^  version  number  :  %d.%d\n*', 

emmver/10,  emmver%10) ; 


If  (  (numpage  -  ejns_num_page () )  —  EMS_ERR)  /*  get  number  of  pages  */ 
prlnt_err();  /*  error:  output  error  message  and  end  program  */ 

prlntf ("Number  of  EMS  pages  :  %d  (%d  KByte) \n", 

numpage,  nunpage  «  4) ; 


If  (  (numpage  -  «ns_f ree jpage  ( ) )  **  EMS_ERR) 
prlnt_err();  /*  Error:  output  error  message  and  end  program  */ 

prlntf("...  free  :  %d  (%d  KByte) \n", 

numpage,  numpage  «  4) ; 


If  (  (Int)  (pageseg  -  ems_f rame_seg  ( ) )  “  EMSJERR) 
prlnt_err();  /*  Error:  output  error  message  and  end  program  */ 

pr Int f ("Segment  address  of  the  page  frame:  %X\n",  pageseg); 

prlntf ("\nNow  a  page  will  be  allocated  from  the  EMS  memory  and\n"); 
prlntf("the  screen  contents  will  be  copied  fran  the  video  RAM\n"); 
prlntf ("to  this  page.Xn"); 

prlntf ("  ...  press  any  )cey\n"); 

getchO;  /*  wait  for  a  Jcey  */ 


/★ —  allocate  a  page  and  map  It  to  the  first  logical  page  In  - */ 

/* —  page  frame.  - */ 

If  (  (handle  -  ems_alloc (1) )  —  EMS_ERR) 
prlnt_err();  /*  Error:  output  error  message  and  end  program  */ 

If  (  I ems_map (handle,  0,  0)  )  /*  set  mapping  */ 

prlnt_err();  /*  Error:  output  error  message  and  end  program  */ 

/* —  copy  4000  bytes  from  the  video  RAM  to  the  EMS  memory - */ 

memcpy (PAGE_ADR (0 ) ,  vr_adr ( ) ,  4000) ; 
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for  (1-0;  1<24;  ++1)  /*  clear  the  screen  */ 

print f ("\n") ; 

printfCThe  old  screen  contents  will  now  be  cleared  and  will  beXn"); 
printf  ("lost .  But  since  it  was  stored  in  the  EMS  memory,  they\n"); 
printf("can  be  copied  from  there  back  into  the  video  RAM.\n"); 
printf ("  ...  press  any  key\n"); 

getchO;  /*  wait  for  a  key  */ 

/* —  copy  the  contents  of  the  video  RAM  fran  the  EMS  memory  - */ 

/★ —  and  release  the  allocated  EMS  memory  again.  - */ 

memcpy  (vr_adr  0  ,  PAGE_ADR(0),  4000);  /*  copy  VRAM  back  */ 

if  (  !ems_free (handle)  )  /*  release  memory  */ 

print_err();  /*  Error:  output  error  message  and  end  program  */ 

printf  ("END") ; 

} 

else  /*  the  EMS  driver  was  not  detected 

printf ("No  EMS  memory  Installed. \n") ; 

} 


Pascal  listing:  EMMP.PAS 


* 

* 

E  M  M  P 

.  ★ 

* 

Task  : 

Implement  certain  functions  to  demonstrate 

★ 

* 

access  to  EMS  memory  using  EMM. 

★ 

_ k 

* 

Author  ; 

MICHAEL  TISCHER 

k 

•k 

Developed  on  : 

08/30/1988 

k 

* 

Last  update  : 

06/21/1989 

k 

^ *★★★★***★**★**★**********★*******************★***★★*★**★****★**★* 


program  EMMP; 

Uses  Dos,  CRT; 

type  ByteBuf  - 

array [0. .1000] 

of  byte; 

{  Add  DOS  and  CRT  units 

{  One  memory  range  as  bytes 

CharBuf  - 

array [0. .1000] 

of  char; 

{  One  memory  range  as  chars 

BytePtr  = 

^ByteBuf; 

{  Pointer  to  a  byte  range 

CharPtr  - 

'^CharBuf; 

{  Pointer  to  a  char  range 

const  EMS  INT 

-  $67; 

{  Interrupt  #  for  access  to  EMM 

EMS  ERR 

-  -1; 

{  Error  if  this  occurs 

W_EMS_ERR 

-  $FFFF; 

{  Error  code  in  WORD  form 

EinnName 

:  array[0..7] 

of  char  - 

^  'EMMXXXXO';  {  Name  of  EMM 

var  EnmEC, 
i 

:  byte; 

{  Allocation  of  EMM  error  codes 
{  Loop  counter 

Handle, 

{ 

Handle  for  access  to  EMS  memory 

EinnVer 

:  Integer; 

{  Version  number  of  EMM 

NumPage, 

PageSeg 

:  word; 

{  Number  of  EMS  pages 
{  Segment  address  of  page  frame 

Keypress 

:  char; 

I ********************************************************************** j 

{*  MK_FP:  Creates  a  byte  pointer  from  the  given  segment  and  offset 
{ *  addresses .  * } 

{*  Input  :  -  Seg  -  Segment  to  which  the  pointer  should  point  *) 

K*  -  Ofs  -  Offset  addr.  to  which  the  pointer  should  point 

Output  :  Entire  pointer 

{*  Info  :  The  returned  pointer  can  be  recast  toward  any  other  *} 

{*  pointer. 

^**********************************************************************^ 

{$F+}  {  This  routine  is  intended  for  a  FAR  model,  and  } 

{  should  therefore  be  treated  as  one  UNIT  } 
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function  MK_FP(  Seg,  Ofs  ;  word  )  :  BytePtr; 


begin 

inline  (  $8B  /  $46 
$89  /  $46 
$8B  /  $46 
$89  /  $46 

end; 


$08  / 

(  mov 

ax, [bp+8] 

$FE  / 

(  mov 

[bp-2], ax 

$06  / 

{  mov 

ax,  [1:^+6] 

$FC  ); 

(  mov 

[bp-4], ax 

(Get  segment  address) 
(and  place  in  pointer) 
(Get  offset  address) 
(and  place  in  pointer) 


) 

) 

) 

} 


{$F-) 


Re-enable  NEAR  routines  ) 


{ ★***★**★**★**★*★* *************************** A**********************  ^ 

{*  Emsinst:  Determines  the  existence  of  EMS  and  corresponding  EMI  *) 
(*  Input  :  none  *} 
{*  Output  :  TRUE  if  EMS  is  available,  otherwise  FALSE  *) 
^ ***************************************************** *****************^ 


function  Emsinst  :  boolean; 

var  Regs  :  Registers;  {  Processor  register  for  the  Interrupt  call  ) 

Name  ;  CharPtr;  {  Pointer  to  the  EMM  names  } 

i  :  integer;  {  Loop  counter  ) 

begin 

{* —  Move  pointer  to  name  in  device  driver  header - *) 

Regs. ax  :*  $3567;  {  Function  #:  Get  interrupt  vector  $67) 

MsDos(  Regs  );  {  Call  DOS  interrupt  $21  ) 

Name  CharPtr (MK_FP (Regs.es,  10));  {  Move  pointer  ) 

{* - Search  for  EMS  driver - *} 

i  :*  0;  {  start  ccxnparison  with  first  character  } 

while  ( (i<si2eof  (EmmName) )  and  (Name'"  [l]»EiranName[i] ) )  do 

Inc (  1  ) ;  {  Increment  loop  counter  } 

Emsinst  (i  «  si zeof (EmmName) ) ;  {  TRUE  if  name  is  found  } 

end; 


!**********************************************************************! 
{*  ElmsNumPage:  Determines  the  total  number  of  EMS  pages  *} 

{*  Input  :  none  *} 

{*  Output  ;  EMS_ERR  if  error  occurs,  otherwise  number  of  EMS  pages  *} 

^ **********************************************************************  I 


function  EmsNumPage  :  integer; 


var  Regs  :  Registers; 


{  Processor  register  for  the  Interrupt  call  } 


begin 

Regs. ah  :=  $42; 

Intr (EMS_INT,  Regs) ; 
if  (Regs. ah  <>0  )  then 
begin 

EmraEC  :=  Regs. ah; 
EmsNumPage  :=  EMS_ERR; 
end 
else 

EmsNumPage  Regs.dx; 

end; 


{  Function  #:  Determine  number  of  pages  ) 

{  Call  EMM  } 
{  Error  occurred?  } 
{  YES  } 
{  Get  error  code  } 
(  Display  error  } 

{  No  error  } 
{  Return  total  number  of  pages  } 


^ ********************************************************************** j 


{*  EmsFreePage;  Determines  the  number  of  free  EMS  pages  *} 
{*  Input  :  none  *} 
{*  Output  :  EMS_ERR  if  error  occurs,  otherwise  the  number  of  un-  *} 
{*  used  EMS  pages  *} 


I  ********************************************************************** j 

function  EmsFreePage  :  integer; 

var  Regs  :  Registers;  {  Processor  register  for  the  interrupt  call  } 
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begin 

Regs. ah  :»  $42; 

Intr (EMS_INT,  Regs) ; 
if  (Regs. ah  <>0  )  then 
begin 

EimEC  :«  Regs. ah; 
EmsFreePage  :»  EMS_ERR; 
end 
else 

EmsFreePage  Regs.bx; 

end; 


Function  #:  Determine  no.  of  pages  } 
{  Call  EMM  } 
{  Error  occurred?  } 
{  YES  } 
(  Mark  error  code  } 
{  Display  error  } 

{  No  error  } 
{  Return  number  of  free  pages  } 


*******************★**************************************************} 

*  EmsFrameSeg:  Determines  the  segment  address  of  the  page  frame  *} 

*  Input  :  none  *} 

*  Output  :  EMS_ERR  if  error  occurs,  otherwise  the  segment  address  *} 
********************************************************************** } 


function  EmsFrameSeg  :  word; 


var  Regs  :  Registers; 


{  Processor  register  for  the  interrupt  call  } 


begin 

Regs. ah  :»  $41; 

Intr (EMS_INT,  Regs) ; 
if  (Regs. ah  <>0  )  then 
begin 

EnrniEC  ;«  Regs. ah; 
EmsFrameSeg  ;»  W_EMS_ERR; 
end 
else 

EmsFrameSeg  :»  Regs.bx; 

end; 


{  Function  #:  Get  segment  addr.  page  frame  } 

{  Call  EMM  } 
(  Error  occurred?  } 
{  YES  } 
{  Mark  error  code  } 
{  Display  error  } 


{  No  error  } 

{  Return  segment  addr.  of  page  frame  } 


^  ****** ************************** ****************************** ******** } 


{*  EmsAlloc:  Allocates  the  specified  number  of  pages  and  returns  a  *} 
{*  handle  for  access  to  these  pages  *} 
{*  Input  ;  PAGES;  Number  of  allocated  pages  *} 
{*  Output  :  EMS_ERR  returns  error,  otherwise  the  handle  *} 


I**********************************************************************} 


function  EmsAlloc (  Pages  :  integer  )  :  integer; 

var  Regs  :  Registers;  {  Processor  register  for  the  interrupt  call} 

begin 

Regs. ah  :=  $43; 

Regs.bx  Pages; 

Intr (EMS_INT,  Regs) ; 
if  (Regs. ah  <>0  )  then 
begin 

EirmEC  :»  Regs. ah; 

EmsAlloc  ;=  EMS_ERR; 
end 
else 

EmsAlloc  :*  Regs.dx; 

end; 

^ ********************************************************************** ^ 
{*  EmsMap  :  Creates  an  allocated  logical  page  from  a  physical  page  in*} 


{*  the  page  frame  *} 
{*  Input  :  HANDLE;  Handle  received  from  EmsAlloc  *} 
{*  LOGP  ;  Logical  page  about  to  lae  created  *} 
{*  PHYSP  ;  The  physical  page  in  page  frame  *} 
{*  Output  :  FALSE  if  error,  otherwise  TRUE  *} 


^ ************************************************************* *********j 


{  Function  #;  Alocate  pages  } 
{  Set  number  of  allocated  pages  } 
{  Call  EMM  } 
{  Error  occurred?  } 
{  YES  } 
{  Mark  error  code  } 
{  Display  error  } 

(  No  error  } 
{  Return  handle  } 


function  EmsMap (Handle,  LogP  ;  Integer;  PhysP  ;  kjyte)  ;  boolean; 

var  Regs  ;  Registers;  {  Processor  register  for  the  interrupt  call  } 
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begin 

Regs. ah  $44; 

Regs.al  ;«  PhysP; 
Regs.bx  LogP; 

Regs.dx  Handle; 

Intr (EMS_INT,  Regs); 
EininEC  :«  Regs. ah; 
EmsMap  (Regs. ah  »  0) 

end; 


{  Function  #:  Set  mapping  } 
(  Set  physical  page  ) 
{  Set  logical  page  } 
{  Set  EMS  handle  } 
{  Call  EMM  } 
{  Mar)c  error  code  ) 
TRUE  is  returned  if  no  error  } 


^  ****** **★****★*★*****★★***★**★*****★★* ********★★*★★*★****★★ ***********  j 

{*  EmsFree  :  Frees  memory  when  given  with  an  allocated  handle  *} 

{*  Input  :  HANDLE:  Handle  received  by  AllocEms  *} 

{*  Output  :  FALSE  if  an  error,  otherwise  TRUE  *) 

^  ********************************************************************** ) 

function  EmsFree (Handle  :  integer)  ;  boolean; 

var  Regs  :  Registers;  {  Processor  register  for  the  Interrupt  call  } 

begin 

Regs. ah  $45; 

Regs.dx  handle; 

Intr (EMS_INT,  Regs) ; 

EmmEC  Regs. ah; 

EmsFree  (Regs. ah  »  0) 

end; 


(  Function  #:  Release  page  ) 
{  Set  EMS  handle  } 
{  Call  EMM  ) 
{  Mark  error  code  } 
{  TRUE  is  returned  if  no  error  } 


I ***************************************************** *****************} 


{*  EmsVersion:  Determines  the  version  number  of  EMM  *} 
{*  Input  ;  none  *1 
{★  Output  :  EMS_ERR  if  error  occurs,  otherwise  the  version  number  ♦} 
{*  {11“1.1,  40=4.0,  etc.)  *} 


^*****************************★♦**************★************************1 
function  EmsVersion  :  integer; 


var  Regs  :  Registers; 


{  Processor  register  for  the  Interrupt  call  ) 


begin 

Regs. ah  :=  $46;  {  Function  #: 

Intr (EMS_INT,  Regs) ; 
if  (Regs. ah  <>0  )  then 
begin 

ErraiEC  :»  Regs. ah; 

EmsVersion  :=  EMS_ERR; 
end 

else  {  No  error,  confute  version  number  frc«n  BCD  number  } 

EmsVersion  :»  (Regs.al  and  15)  +  (Regs.al  shr  4)  *  10; 
end; 


Determine  EMM  version  } 
{  Call  EMM  ) 
{  Error  occurred?  } 
{  YES  1 
{  Mark  error  code  ) 
{  Display  error  } 


f ********************************************************************** j 

{*  EmsSaveMap:  Saves  dispay  between  logical  and  physical  pages  of  the  *} 
given  handle  *} 

{*  Input  :  HANDLE:  Handle  assigned  by  EmsAlloc 

{*  Output  :  FALSE  if  error  occurs,  otherwise  TRUE  *} 

j ***************************************************************** *****j 


function  EmsSaveMap (  Handle  :  integer  )  :  boolean; 


var  Regs  :  Registers;  {  Processor  register  for  the  interrupt  call  } 


begin 

Regs. ah  :*  $47; 

Regs.dx  :=  handle; 

Intr (EMS_INT,  Regs) ; 

EmmEC  :=  Regs. ah; 
EmsSaveMap  :=  (Regs. ah  =  0) 
end; 


{  Function  #:  Map  save  } 
{  Set  EMS  handle  ) 
{  Call  EMM  1 
{  Mark  error  code  } 
{  Return  TRUE  if  no  error  } 
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I  ********************************************************************** ) 

{*  EmsRestoreMap:  Returns  display  between  logical  and  physical  pages, 

{*  from  the  page  saved  by  EmsSaveMap 

{*  Input  :  HANDLE:  Handle  assigned  EmsAlloc  *) 

Output  :  FALSE  if  an  error  occurs,  otherwise  TRUE 
^ ************************************************************** ********) 

function  EmsRestoreMap (  Handle  :  integer  )  :  boolean; 

var  Regs  :  Registers;  {  Processor  register  for  the  interrupt  call  } 

begin 

Regs. ah  $48; 

Regs.dx  :»  handle; 

Intr  (EMS_INT,  Regs)  ; 

EmmEC  Regs. ah; 

EmsRestoreMap  :«  (Regs. ah  «  0) 
end; 

^ ******************************************************************** **j 


PrintErr:  Displays  an  error  message  and  ends  the  program  *} 
{*  Input  :  none  *} 
{*  Output  :  none 

{*  Info  :  This  function  is  called  only  if  an  error  occurs  during  a  ’‘J 
{*  function  call  within  this  module  *} 


^ ******************************************************************** **^ 

procedure  PrintErr; 

begin 

wrlteln ( 'ATTENTION!  Error  during  EMS  memory  access'); 
write  ('  ...  '); 

if  ( (EmmEC<$80)  or  (EmmEc>$8E)  or  (EmmEc-$82) )  then 
writeln( 'Unidentifiable  error') 
else 

case  EmmEC  of 
$80 
$81 
$83 
$84 
$85 
$86 
$87 

$88 
$89 
$8A 
$8B 
$8C 
$8D 
$8E 

end; 

Halt; 
end; 

^ ********************************************************************** j 

{*  VrAdr:  Returns  a  pointer  to  video  RAM  ’‘I 

{*  Input  :  none  *) 

{*  Output  :  Pointer  to  video  RAM  *) 

f ******************************************************** **************} 

function  VrAdr  :  BytePtr; 

var  Regs  :  Registers;  {  Processor  register  for  the  interrupt  call  ) 

begin 

Regs. ah  :»  $0f;  {  Function  #:  Determine  video  mode  J 

Intr ($10,  Regs);  {  Call  BIOS  video  interrupt  ) 


:  writelnCEMS  driver  error  (EMM  trouble)  '); 

:  writeln ( ' EMS  hardware  error ' ) ; 

:  writeln ('Illegal  EMi  handle'); 

:  writeln ('Called  EMS  function  does  not  exist'); 

:  writeln ('No  more  free  EMS  handles  available'); 

:  writeln ('Error  while  saving  or  restoring  mapping  '); 

:  writeln ('More  pages  requested  than  are  actually  ', 
'available' ) ; 

:  writeln ('More  pages  requested  than  are  free'); 

:  writeln ( ' No  pages  requested ' ) ; 

:  writeln ('Logical  page  does  not  belong  to  handle'); 

:  writeln (' Illegal  physical  page  number'); 

:  writeln ('Mapping  menory  range  is  full'); 

:  writeln ('Map  save  has  already  been  done'); 

:  writeln ('Mapping  must  be  saved  before  it  can', 

'be  restored'); 

{  Program  end  } 


{  Function  #:  Restore  map  } 
(  Set  EMS  handle  } 
(  Call  EMM  ) 
{  Mar)c  error  code  } 
{  TRUE  returned  if  no  error  ) 
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if  (Regs.al  -  7)  then 
VrAdr  MK_FP($BOOO,  0) 

else 

VrAdr  MK_FP($B800,  0); 

end; 


{  Monochrome  video  card?  } 
{  YES,  video  RAM  at  B000:0000  } 
{  Color,  EGA  or  VGA  card  } 
{  Video  RAM  at  B800:0000  } 


{********«******★******************************************************} 
{*  PageAdr:  Returns  address  of  a  physical  page  in  page  frame  *} 

{*  Input  :  PAGE:  Physical  page  number  (0-3)  *) 

{*  Output  :  Pointer  to  the  physical  page  *} 


function  PageAdr (  Page  :  integer  )  :  BytePtr; 
begin 

PageAdr  MK_FP (  EmsFrameSeg  +  (Page  shl  10),  0  ); 
end; 

^  ***★★* ************************************************************* } 
{**  MAIN  PROGRAM  **} 

I  ****** ****************** *********★******★*****************************} 


begin 

ClrScr; 

writelnCEMMP  - 
if  Erasinst  then 
begin 


{  Clear  screen  } 

(c)  1988  by  MICHAEL  TISCHER' , #13#10)  ; 

{  Is  EMS  memory  installed?  } 
{  YES  } 

{* —  Display  EMS  memory  information - *} 


EmnVer  :*  EmsVersion;  {  Determine  EMM  version  number  } 

if  EirmVer  =  EMS__ERR  then  {  Error  occurred?  ) 

Print Err;  {  YES,  Display  error  message  and  end  program  } 

writelnCEtW  Version  number  ;  ',EmmVer  div  10, 

EirmVer  mod  10) ; 


NumPage  EmsNumPage;  (  Determine  total  number  of  pages  } 

if  NumPage  -  EMS_ERR  then  {  Error  occurred?  } 

Print Err;  {  YES,  Display  error  message  and  end  program  ) 

writeln ('Number  of  EMS  Pages  :  ',  NumPage,  '  (*, 

NumPage  shl  4,  *  KByte)'); 

NumPage  :=  EmsFreePage;  {  Determine  number  of  free  pages  ) 

if  NumPage  -  EMS__ERR  then  (  Error  occurred?  } 

PrintErr;  {  YES,  Display  error  message  and  end  program  } 

writeln ('...  free  EMS  pages  remaining  :  ',  NumPage,  '  (*, 

NumPage  shl  4,  '  KByte)'); 

PageSeg  :»  EmsFrameSeg;  {  Segment  address  of  page  frame  } 

if  PageSeg  =  W__EMS_ERR  then  {  Error  occurred?  } 

PrintErr;  {  YES,  Display  error  message  and  end  program  } 

writeln (' Segment  address  of  page  frame:  ',  PAgeSeg) ; 


writeln; 

writeln ('Now  a  page  from  EMS  memory  can  be  allocated,  and  the'); 
writeln ('screen  contents  can  be  copied  from  video  RAM  into  this'); 
writeln ( 'page. ' ) ; 

writeln ('  ...  Please  press  a  key'); 

Keypress  :«  ReadKey;  (  Wait  for  a  keypress  } 

{* —  Page  is  allocated,  and  the  data  is  passed  to  the  first - *} 

{* —  logical  page  in  the  page  frame  - 

Handle  :-  EmsAlloc(  1  );  {  Allocate  one  page  ) 

if  Handle  -  EMS_ERR  then  (  Error  occurred?  } 

PrintErr;  {  YES,  Display  error  message  and  end  program  } 

if  not (EmsMap (Handle,  0,  0))  then  (  Set  mapping  } 

PrintErr;  {  Error:  Display  error  message  and  end  program  } 

{* —  Copy  4000  bytes  from  video  RAM  into  EMS  memory  — *} 
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Move (VrAdr^,  PageAdr(O)^,  4000); 

ClrScr;  {  Clear  screen  ) 

while  KeyPressed  do  {  Read  keyboard  buffer  } 

Keypress  ReadKey; 

wrltelnCOld  screen  contents  are  cleared.  However,  the  data  •); 
writeln (' from  the  screen  is  in  EMS,  and  can  be  re-copied  onto  *>; 
writelnCthe  screen.  '); 

writeln ('  ...  Please  press  a  key'}; 

Keypress  ReadKey;  {  Walt  for  a  keypress  ) 

{* —  Copy  contents  of  video  RAM  frcxn  EMS  memory  and  release  — *) 
{*—  the  allocated  EMS  memory  — *} 

Move  (PageAdr  (0) VrAdr'^,  4000);  {  Copy  over  video  RAM  ) 

if  not  (EmsFree  (Handle) )  then  {  Release  memory  } 

PrintErr;  {  Error:  Display  error  message  and  end  program  ) 

GotoXYd,  15); 
writeln ('END') 
end 

else  {  ems  driver  not  available  ) 

writeln ('ATTENTIC»I!  No  EMS  memory  installed.'); 
end. 
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A  few  years  ago  mice  were  considered  luxuries  for  PC  applications.  Today  most 
PCs  have  mice  connected  to  them.  Part  of  the  mouse’s  popularity  stems  from  the 
development  of  new  and  more  powerful  video  standards  such  as  EGA  and  VGA. 
These  graphic  cards  helped  advance  the  graphic  user  interfaces  such  as  GEM®  and 
Microsoft  Windows®,  which  are  almost  unusable  without  a  mouse. 

Applications  and  operating  systems  alike  benefit  from  mouse  support.  Ventura 
Publisher®  and  Microsoft  Works®  both  make  intensive  use  of  the  mouse.  In 
addition,  DOS  Version  4.0  accepts  mouse  as  well  as  keyboard  input. 

A  software  interface  acts  as  the  connection  between  a  program  and  the  mouse. 
Microsoft  Corporation  designed  this  interface  for  its  own  mice,  but  other  mouse 
manufacturers  accept  this  interface  as  a  standard.  The  interface  was  made  available 
to  the  industry  as  a  minimum  standard  to  retain  compatibility  with  the  Microsoft 
mouse. 

This  function  interface  is  usually  installed  either  through  a  device  driver  which  is 
loaded  during  system  boot,  or  through  a  terminate  and  stay  resident  (TSR)  program 
such  as  MOUSE.COM,  included  with  the  Microsoft  mouse  package. 

Mouse  functions 

Mouse  functions  may  be  accessed  in  the  same  way  as  DOS  and  BIOS  functions 
(you  may  wish  to  review  the  techniques  used  for  addressing  DOS  and  BIOS 
functions — see  Chapters  6  and  7  for  more  information).  The  individual  functions 
can  be  called  through  interrupt  33H.  The  identification  number  of  the  function 
must  be  passed  to  the  AX  register.  The  other  processor  registers  are  used  in  various 
combinations  for  passing  information  to  a  function. 

A  total  of  34  different  functions  can  be  called  in  this  manner,  but  most 
applications  use  only  a  few  of  these  functions.  Before  we  examine  each  function, 
let’s  look  at  the  concepts  behind  the  mouse  interface.  This  will  help  you  to 
understand  the  way  individual  functions  woik.  We  delib^tely  concentrated  here  on 
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text  oriented  mouse  control.  Pixel  oriented  applications  should  use  a  graphic 
interface  such  as  Windows  or  GEM  from  the  start,  because  they  provide  friendlier 
functions  for  mouse  input  than  the  programming  interface  offered  in  this  chapter. 

About  mouse  buttons 

Unlike  the  keyboard,  which  has  many  keys  and  keyboard  codes  for  each  key,  a  PC 
mouse  usually  has  two  or  even  three  mouse  buttons.  These  mouse  buttons  permit 
the  user  to  select  data  in  an  application  program.  Another  important  piece  of 
information  is  the  actual  position  of  the  mouse's  pointer  (cursor)  on  the  screen. 
The  word  pointer  stems  from  the  pointer's  usual  shape:  an  arrow  or  a  pointing 
finger. 

The  mouse  driver  software  always  interprets  the  pointer's  location  on  the  screen 
relative  to  a  virtual  gn^hic  screen.  This  virtual  screen’s  resolution  depends  on  the 
video  mode  and  video  card  currently  in  use.  Since  this  virtual  graphic  display 
screen  is  also  used  within  the  text  modes  to  determine  the  mouse's  position  and 
forms  the  basis  for  communication  with  the  mouse  interface,  a  conversion  occurs 
between  the  graphic  coordinates  and  the  mouse  pointer's  line/column  position. 
Since  every  column  or  line  corresponds  to  eight  pixels,  the  graphic  coordinates 
must  be  either  divided  by  eight  or  left  shifted  by  three  places  in  binary  mode, 
which  mathematically  produces  the  same  result.  The  processor  executes  the 
shifting  much  faster  than  it  can  execute  the  actual  division. 

More  about  the  mouse  pointer 

The  points*  shows  the  mouse's  relative  location  on  the  screen.  Its  shape  can  vary 
from  application  to  application,  and  it  can  even  change  appearance  within  an 
application.  Word  processors  often  display  the  mouse  pointer  as  a  block,  similar  to 
the  text  cursor.  In  text  mode  the  application  can  only  determine  the  starting  and 
ending  line  of  the  pointer.  The  pointer's  size  depends  on  the  current  character 
matrix  and  video  mode.  The  options  for  creating  a  software  pointer  are  more 
complex,  since  two  16-bit  values  called  the  screen  mask  and  cursor  mask  govern 
the  pointer's  appearance. 

The  mouse  driver  must  determine  the  appearance  of  the  pointer  every  time  the 
pointer  changes  position  on  the  screen.  The  cursor  mask  and  screen  mask  values 
are  linked  with  the  two  bytes  which  describe  the  character  code  and  the  character 
color  within  video  RAM.  This  linkage  occurs  in  two  steps.  First  the  character  code 
and  the  attribute  byte  are  linked  with  screen  mask  through  a  binary  AND.  The 
result  of  this  connection  is  then  linked  with  the  cursor  mask  through  an  exclusive 
OR.  The  result  then  appears  on  the  screen. 
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This  type  of  linkage  allows  a  number  of  options  for  changing  the  pointer's 
appearance.  Four  of  the  most  common  pointer  options  are: 

•  Points  spears  as  one  spcciric  chaiact^  in  one  specific  color 

•  Pointer  appears  as  one  specific  character,  but  color  changes  when  the 
pointer  overk^s  a  character  (e.g.,  inverse  video) 

•  Pointo*  £^)pears  as  one  specific  characto*,  but  the  character  color  changes 
when  the  pointo^  overlaps  a  characto* 

•  Pointer  appears  as  one  specific  character,  but  character  color  changes  to  a 
variant  of  the  charact^  color  when  the  pointo*  overlaps  a  charact^ 

The  standard  measurement  unit  in  the  mouse  interface  is  the  mickey  ^  named  after 
Mickey  Mouse®  (1  mickey  =  1/200").  The  mouse  hardware  measures  all  distances 
in  multiples  of  mickeys.  We  will  use  this  as  the  measurement  standard  throughout 
the  rest  of  this  chapter. 

Function  OOH:  Reset  mouse  driver 

A  program  should  call  the  function  OOH  before  calling  any  of  the  mouse  functions. 
This  resets  the  mouse  driver.  It  can  also  determine  whether  a  mouse  and  mouse 
driver  exist,  by  examining  the  content  of  the  AX  regist^  after  the  function  call.  If 
the  AX  regist^  contains  the  value  OOOOH  after  the  function  call,  no  mouse  driver 
was  installed.  Even  if  a  mouse  is  connected,  the  mouse  driwer  no  longer  exists.  If  a 
mouse  driver  and  mouse  exist,  function  OOH  returns  the  value  FFFFH  in  the  AX 
register.  The  BX  register  contains  the  number  of  buttons  on  the  mouse.  As 
mentioned  above,  PC  mice  usually  have  two  mouse  buttons,  although  some  mice 
have  three  buttons.  Since  very  few  applications  need  or  use  three  buttons,  two 
buttons  will  be  all  you'll  need  in  most  cases. 

Function  OOH  resets  the  numerous  mouse  parameters  to  their  default  values.  The 
mouse  pointer  moves  to  the  cent^  of  the  screen.  The  cursor  mask  and  screen  mask 
are  defined  in  such  a  manner  that  the  cursor  s^pears  as  an  inv^^  video  rectangle. 
Video  page  0  is  selected  as  the  default  page  on  which  the  pointer  appears.  The 
pointer  dis£^;)ears  from  the  screen  immediately. 

Function  01 H:  Display  mouse  pointer 

Function  OlH  displays  the  pointer  on  the  screen.  Load  the  function  number  into 
the  AX  legists;  no  o^o*  parameters  are  needed.  Since  the  mouse  driver  follows  the 
movement  of  the  mouse  even  when  the  mouse  pointer  has  been  disabled,  it  may 
not  necessarily  reappear  at  the  position  where  it  was  when  it  disappeared. 
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Function  02H:  Remove  mouse  pointer 

Function  02H  removes  the  mouse  pointer  from  the  screen.  Load  the  function 
number  into  the  AX  register;  no  other  parameters  are  needed.  The  calls  between 
functions  OlH  and  02H  must  be  called  in  proper  prtqxvtions  to  be  effective.  Fw 
example,  calling  function  02H  twice  in  succession  means  that  you  must  also  call 
function  OlH  twice  in  succession  to  return  the  pointer  to  the  screen. 

Functions  OlH  and  02H  aroi't  used  very  much.  Often,  all  you'll  need  to  do  is  call 
function  OOH  and  function  OlH  at  the  beginning  of  a  {Hogram,  and  call  function 
02H  at  the  end  of  the  program.  These  functions  come  into  play  more  frequrady  if 
the  application  program  writes  characters  direcdy  into  vidM  RAM,  bypassing  the 
slow  DOS  and  BIOS  display  routines.  Avoid  writing  characters  over  the  mouse 
pointer,  or  two  things  will  happen: 

1)  The  mouse  points  distqrpears  if  ovowrittoi  by  anotho'  character. 

2)  The  mouse  driver  produces  the  wrong  character  on  the  screen  when  the 
user  moves  the  mouse  pointer.  Before  the  pointer  spears  at  a  certain 
position  on  the  screen,  it  records  the  character  which  occupied  this 
position  until  now.  This  character  is  restored  to  the  old  position  as  soon 
as  the  pointer  moves  to  another  position  on  the  screen.  During  a  direct 
write  access  to  video  RAM,  the  driver  does  not  record  that  a  new  charact^' 
was  output  at  the  position  of  the  pointer.  Therefore,  the  old  (and 
incorrect)  characto*  is  displayed  on  the  screen  during  the  movement  of  the 
pointer. 

You  can  avoid  this  potential  source  of  enors  by  removing  the  pointer  before 
character  output,  and  returning  the  old  charact^  to  the  screen.  The  new  character 
will  be  stored  when  the  pointer  is  restored  to  the  screen.  This  action  should  not  be 
done  for  every  character  ouqmt,  since  it  slows  the  system  down  and  negates  the 
advantages  of  direct  access  to  video  RAM.  We  rec(Mnmend  that  you  rmove  the 
pointer  once  from  the  screen  before  extensive  ouQrut  such  as  construction  of  a 
screen  window.  Aft^  the  operation  the  points  can  be  restored  on  the  screen. 

Even  though  the  DOS  and  BIOS  character  output  functions  write  their  ouq)ut 
directly  to  video  RAM,  you  shouldn't  worry  about  programming  the  pointer  when 
working  with  these  functions  The  reason  is  that  during  installation,  the  mouse 
drivo’  moved  interrupt  vector  lOH,  which  handles  BIOS  and  DOS  screen  ouQrut,  to 
its  own  routine.  The  driva*  can  then  display  or  disable  the  pointer  as  needed. 

Function  04H:  Move  mouse  pointer 

Function  (HH  allows  movement  of  the  pointer  to  a  specific  location  on  the  screen, 
without  moving  the  mouse.  Pass  the  function  number  to  the  AX  register,  the  new 
horizontal  coordinate  (column)  to  the  CX  regista,  and  the  new  vertical  coordinate 
(line)  to  the  DX  register.  Please  note  that  these  coordinates,  like  all  other 
functions,  must  be  relative  to  the  virtual  screen.  Text  coordinates  must  be 
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multiplied  by  eight  shifted  left  three  binary  places)  before  they  can  be  passed  to 
function  04H.  The  coordinates  must  be  loca^  inside  a  screen  area  designated  as 
the  mouse's  range  of  movement 

Function  OOH  sets  the  complete  range  of  the  mouse's  movement  to  the  entire 
screen  area.  Functions  07H  and  OSH  limit  this  range  to  a  smaller  area. 

Function  07H  &  OSH:  Set  range  of  movement 

Function  07H  specifies  the  horizontal  range  of  movement  Pass  the  function 
numba  to  the  AX  register,  the  minimum  X-cowdinate  to  the  CX  register  and  the 
maximum  X-co(vdinale  to  the  DX  register. 

Function  OSH  specifies  the  vmical  range  of  movement  Pass  the  fimcdon  number 
to  the  AX  register,  the  minimum  Y-coordinate  to  the  CX  register  and  the 
maximum  Y-coordinate  to  the  DX  register. 

After  calling  these  functions  the  mouse  driver  automatically  moves  the  pointer 
within  the  range,  unless  it  is  already  within  the  indicated  bordos.  The  user  cannot 
move  the  points  outside  this  range. 

Function  10H:  Exclusion  area 

In  addition  to  the  area  of  movement  allotted  to  the  points',  the  mouse  driver  also 
supplies  an  exclusion  area.  This  exclusion  area  is  a  section  of  the  screen  which 
renders  the  mouse  pointer  invisible  when  the  user  moves  the  pointer  into  this 
section.  The  mouse  pointer  becomes  visible  again  as  soon  as  the  us»  moves  the 
pointer  away  firom  the  exclusion  area.  This  area  is  undefined  after  the  call  of 
function  OOH.  It  can  be  defined  at  any  time  by  calling  function  lOH,  but  the 
mouse  drivo:  can  control  only  one  exclusion  area  at  a  time.  The  cowdinates  of  the 
exclusion  area  are  passed  to  function  lOH  in  the  CX:DX  and  SI:DI  registo*  pairs. 
These  register  pairs  specify  the  upper  left  comer  and  lower  right  comer 
respectively.  CX  and  SI  accept  the  X-co(»dinatB,  DX  and  DI  the  Y-coordinate. 

The  exclusion  area  and  function  02H  play  special  roles  during  direct  access  to  video 
RAM.  Although  function  02H  removes  the  pointer  fipom  the  screen,  this  can  occur 
in  conjunction  with  function  lOH  only  if  the  pointer  is  already  within  the 
exclusion  area,  or  if  the  user  moves  the  points  within  the  exclusion  area.  This 
makes  functimi  lOH  practical  fix  situations  involving  the  creation  of  a  larger 
display  area  (e.g.,  a  window).  This  allows  the  pointer  to  remain  on  the  screen  as 
long  as  it  is  not  within  this  exclusion  area. 

The  exclusion  area  can  be  removed  by  calling  function  OlH  or  function  OOH. 
Function  OlH  makes  the  pointer  visible  automatically  if  it  is  already  within  the 
exclusion  area. 
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Function  1DH:  Set  display  page 

Function  IDH  sets  the  display  page  on  which  the  pointer  appears.  This  function  is 
required  only  if  the  program  switches  a  display  page  otho'  than  the  current  one  to 
the  foreground  through  direct  video  card  programming.  Pass  the  number  of  the 
display  page  to  the  BX  register.  When  BIOS  interrupt  lOH  activates  a  display 
page,  this  function  can  be  omitted,  since  the  mouse  driver  will  automatically  adtpt 
to  the  change. 

Function  OFH:  Set  pointer  speed 

Two  parameters  determine  the  qteed  at  which  the  mouse  pointer  moves  on  the 
display  screen.  They  specify  the  relationship  between  the  distance  of  a  pointer 
movement  and  the  pixels  traversed  in  the  virtual  mouse  display  screen.  Function 
OFH  allows  the  user  to  set  these  parameters  for  horizontal  and  vmtical  movement 
The  parameters  are  passed  in  the  CX  and  DX  regist^s  (horizontal  and  vertical, 
respectively).  These  numbers  indicate  the  number  of  mickeys,  which  correspraid  to 
eight  pixels  in  the  virtual  mouse  display  screen.  These  eight  pixels  correspond  to 
one  line  or  column  in  the  text  mode  ^splay  screen. 

The  default  values  after  calling  function  OOH  are  8  horizontal  mickeys  and  16 
vertical  mickeys.  In  text  mode  the  pointer  moves  one  coluitm  after  the  pointer  is 
moved  8  mickeys  (about  .04")  horizontally.  A  jump  to  the  next  line  occurs  only 
after  the  pointo'  is  moved  16  mickeys  (about  .08")  vertically. 

These  settings  normally  can  be  set  at  default  values,  since  they  work  well  with  all 
resolutions  in  text  mode.  This  function  allows  changes  if  you  want  faster  or 
slower  pointer  movement 

Function  OAH:  Set  pointer  shape 

Function  OAH  determines  the  tq)pearance  of  the  pointer  in  text  mode.  The  cursor 
mask  and  screen  mask  mentioned  above  ate  determining  factors  of  the  pointer's 
appearance  in  text  mode.  Pass  OAH  to  the  AX  register  and  the  value  determining 
the  cursor’s  sh^  to  the  BX  register. 

Software-specific  pointer 

If  the  BX  register  contains  the  value  0,  the  mouse  driver  selects  the  pointer  as 
specified  by  the  software.  The  screen  mask  number  must  be  loaded  into  the  CX 
register,  and  the  cursor  mask  number  must  be  loaded  into  the  DX  regist^.  These 
numbers  indicate  the  addresses  from  which  the  mouse  driver  can  access  pointer 
diqreparametas. 
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Hardware-specific  pointer 

If  the  BX  register  contains  the  value  1,  the  mouse  driver  selects  the  pointer  as 
specified  by  the  hardware.  Starting  line  of  the  hardware  pointer  must  be  loaded  into 
to  the  CX  registCT,  and  the  ending  line  must  be  loaded  into  the  DX  regist^. 

Video  mode  and  pointer  size 

Remember  that  the  allowable  values  for  starting  line  and  ending  line  depends  on 
the  video  mode  currently  in  use: 

•  The  monochrome  display  ad^^ter  allows  values  from  0  to  13. 

•  The  color  graphics  adapter  only  allows  values  from  0  to  7. 

•  EGA  and  VGA  cards  accept  values  from  0  to  7.  The  EGAA^GA  BIOS 
automatically  adapts  the  number  selected  to  the  size  of  die  character 
matrix  currently  in  use. 

The  functions  listed  up  until  now  set  the  various  parameters  which  control  the 
mouse  driver.  The  mouse  driver  also  supports  a  group  of  functions  which  read  the 
mouse's  position  as  well  as  the  status  of  the  mouse  buttons.  These  functions  can 
be  divided  into  two  categories  for  reading  external  devices  such  as  the  mouse, 
keyboard,  printer  or  disk  drives.  These  categories  are  the  polling  method  and  the 
interrupt  method.  The  mouse  driver  suppcxts  both  methods. 

Polling  method 

The  polling  method  constantly  reads  a  device  within  a  loop.  This  loop  terminates 
only  when  the  desired  event  occurs.  Since  the  execution  of  this  loop  requires  the 
full  capabilities  of  the  CPU,  no  time  normally  remains  to  perform  other  tasks. 

Interrupt  method 

The  interrupt  method  has  an  advantage  over  the  polling  method,  since  the  interrupt 
system  allows  the  CPU  to  execute  other  tasks  until  the  desired  event  occurs.  Once 
this  happens,  the  mouse  driver  calls  an  interrupt  routine  which  reacts  to  the  event 
and  executes  further  instructions. 

Function  OSH:  Get  pointer  position/button  status 

The  polling  method  offers  four  functions  which  operate  in  conjunction  with  the 
mouse  interface.  These  functions  can  be  accessed  through  function  03H,  which 
return  the  current  pointer  position  and  mouse  button  status.  Function  03H  passes 
the  horizontal  pointer  position  to  the  CX  register  and  the  vertical  pointer  position 
to  the  DX  register.  Since  these  coordinates  also  refer  to  the  virtual  mouse  screen, 
they  must  be  converted  to  the  text  screen's  coordinate  system  by  dividing  the 
components  by  eight,  or  by  shifting  the  bits  right  by  three  binary  places. 
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The  following  table  shows  how  the  mouse  button  status  is  returned  to  the  BX 
register.  Only  the  three  lowest  bits  rq)resent  the  status  of  one  of  the  two  or  three 
mouse  buttons.  The  bit  for  the  corresponding  mouse  button  contains  the  value  1 
when  the  user  presses  that  mouse  button  during  the  function  call. 

Mouse  button  status  returned  in  the  BX  register  after  calling 
fvLnction  03H 

54321098  76543210<=  Bits 

XXXXXXXXXXXXX _ <=  Disregard  these  bits _ 

1  »  left  mouse  button  activated 
1  »  right  mouse  button  activated 

_ 1  »  center  mouse  button  activated 


Function  OCH:  Set  event  handler 

Function  OCH  sets  the  address  of  a  mouse  event  handler  (interrupt  routine).  The 
function  number  must  be  passed  to  the  AX  register.  The  segment  and  offset  address 
of  the  event  handler  must  be  passed  to  the  ES:DX  register  pair.  The  event  mask 
must  be  passed  to  the  CX  register.  The  individual  bits  of  this  flag  determine  the 
conditions  under  which  the  event  handle*  should  be  called.  The  following  table 
shows  the  CX  regist^  coding: 


1  Event 

mask  coding 

in  CX 

register  during  function  OCH  call  I 

5  4 

3 

2 

1  0  9  8  7 

6  5  4 

3  2  1 

0  ^  Bits 

X  X 

X 

X 

X  X  X  X  X 

<=  Disregard  these  bits 

1  1  -  Mouse  movement  I 

1 

-  Left  mouse  button  activated 

1 

-  Left  mouse  button  released 

1 

-  Right  mouse  button  activated 

1 

-  Right  mouse  button  released 

1 

-  Center  mouse  button  activated 

1 

-  Center  mouse  button  released 

The  mouse  driver  calls  the  event  handler  after  executing  the  function,  as  soon  as  at 
least  one  of  the  specified  events  occurs.  The  call  is  made  using  the  FAR  call, 
rather  than  the  INT  instruction.  This  difference  is  important  to  remember  when 
developing  an  event  handler,  since  the  handler  must  be  ended  with  a  FAR  RET 
instruction  rather  than  an  IRET  instruction.  Similar  to  an  interrupt  routine,  none 
of  the  various  processor  registo's  can  be  changed  when  they  are  returned  to  the 
caller.  For  this  reason  the  registers  must  be  stored  on  the  stack  immediately  after 
the  call,  and  the  register  contents  must  be  restored  at  the  end  of  the  routine. 

Information  is  passed  to  the  event  handler  from  the  mouse  driver  through 
individual  processor  registm.  The  information  concerning  the  event  can  be  found 
in  the  AX  register,  where  each  bit  has  the  same  significance  as  in  the  event  mask 
during  the  call  of  function  OCH  (see  above  table).  Individual  bits  may  be  set  which 
have  no  meaning  for  the  event  handler.  For  example,  if  the  event  handlo*  should 
only  be  called  when  the  left  mouse  button  is  activated  (bit  1),  bits  0  and  4  may 
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also  be  set  during  the  event  handler  call,  because  the  mouse  was  moved  and  the 
right  mouse  button  had  been  released  at  the  same  time. 

The  event  handler  can  obtain  the  current  button  status  from  the  contents  of  the  CX 
register.  The  coding  is  identical  during  the  call  to  the  function  OSH.  Bits  0  to  2 
represent  the  different  mouse  buttons.  The  current  pointer  position  can  be  found  in 
the  CX  and  DX  registers,  representing  the  horizontal  and  vertical  positions, 
respectively.  The  position  can  only  be  set  after  conversion  to  the  text  screen*s 
coordinate  system. 

During  the  development  of  an  event  handler,  the  DS  register  shoiild  point  to  the 
data  segment  of  the  mouse  driv^  during  the  handle  call,  instead  of  the  interrupted 
program.  If  the  event  handle  accesses  its  own  data  segment,  it  must  first  load  its 
address  into  the  DS  register. 

Function  18H:  Install  alternate  event  handler 

Function  18H  allows  the  installation  of  an  event  handler  which  reacts  to  limited- 
range  keyboard  events  as  well  as  mouse  events.  This  function  signals  an  event  if 
the  <Ctrl>,  <Alt>  or  <Shift>  keys  are  pressed  when  a  mouse  button  is  pressed  or 
released. 

This  function  is  almost  identical  in  register  assignments  as  function  OCH.  The 
event  mask  in  the  CX  register  has  been  extended  by  the  three  events,  as  shown  in 
the  following  table: 


Event  mask  coding  in  CX  register  during  function  18H  call 
5432109876543210«=  Bits 

XXXXXXXX  <=  Disregard  these  bits _ 

1  Mouse  movement 
1  »  Left  mouse  button  activated 

1  »  Left  mouse  button  released 

1  »  Right  mouse  button  activated 

1  »  Right  mouse  button  released 

1  =  Shift  key  pressed  during 

mouse  button  event 

1  *  Ctrl  key  pressed  during  mouse 

button  event 

1  *  Alt  key  pressed  during  mouse 

_ button  event _ 


Even  during  the  call  of  such  an  alternative  event  handler,  little  changes  in 
comparison  with  the  event  handlers  which  were  installed  by  calling  function  OCH. 
Only  the  content  of  the  AX  register  must  be  interpreted  a  little  differently,  since  its 
construction  corresponds  to  the  event  mask  shown  above. 

Up  to  three  alternative  event  handlers  can  be  installed  by  calling  function  18H. 
During  the  function  OCH  call,  the  event  handler  indicated  replaces  the  previously 
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installed  handler.  Three  different  event  handle  can  be  installed  by  calling  function 
18H  three  times.  This  is  only  valid  if  the  three  event  handlers  are  equipped  with 
different  event  masks.  If  an  event  mask  passes  to  function  18H  which  is  already 
equipped  with  a  handle,  the  new  handle  rq)laces  the  existing  handle. 

Demonstration  programs 

This  chapter  lists  programs  in  C  and  Turbo  Pascal  which  demonstrate  mouse 
access  functions.  These  programs  show  the  techniques  of  developing  and  installing 
an  event  handler,  which  is  the  most  complicated  part  of  mouse  reading.  Both 
programs  include  functions  or  procedures  which  call  various  mouse  functions. 
These  routines  require  little  programming — they  load  the  processor  registers  with 
the  necessary  values,  then  call  interrupt  33H.  Since  the  event  handler  needs  the 
most  programming,  the  text  here  will  focus  on  that  subject. 

Installing  an  event  handler  in  a  higher  level  language  program  is  somewhat 
difficult,  since  it  must  meet  certain  requirements.  These  requirements  are  normally 
beyond  the  control  of  a  programmer  in  a  high^  level  language.  The  requirements 
are  as  follows: 

•  The  event  handler  must  be  a  FAR  procedure,  and  must  be  tominated  with 
a  FAR  RET  instruction. 

•  The  event  handler  must  store  the  various  processor  registers  during  the 
call  and  restore  them  before  completion. 

•  The  event  handler  must  load  the  segment  address  of  the  higher  level 
language  data  segment  into  the  DS  register  to  provide  access  to  global 
variables  of  the  program. 

These  requirements  can  be  met  in  some  versions  of  Turbo  Pascal,  Turbo  C  and 
Microsoft  C,  although  some  very  complex  programming  would  be  required.  The 
traditional  solution  (write  a  routine  in  assembly  language)  is  easier  and  faster  to 
implement  Therefore,  we  wrote  the  event  handler  itself  in  assembler,  assembled 
the  program  and  linked  the  resulting  object  module  to  the  higher  level  language 
program. 

This  assembler  routine  is  named  AssmHand.  It  stores  the  various  processor 
registers  on  the  stack  after  the  call,  then  calls  a  C  function  or  Pascal  procedure 
named  MouEventHandler.  The  AssmHand  routine  passes  arguments  provided  by 
the  mouse  driver  to  the  MouEventHandl^  routine.  These  arguments  include: 

•  The  event  flag,  which  describes  the  event  that  caused  the  handler  call. 

•  The  current  mouse  button  status. 

•  The  current  position  of  the  mouse  points. 
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This  infonnation  is  converted  from  virtual  gr:q)liic  screen  coordinates  into  text 
screen  cotndinates  (25  lines  x  80  ccdumns). 

The  stack  handles  parameter  passing.  The  C  version  of  AssmHand  must  pass  the 
arguments  (Mito  the  stack  in  die  reverse  mder  of  their  declaration.  After  loading  the 
DS  register  and  calling  the  higher  level  language  routine,  these  arguments  must  be 
taken  from  the  stack  again  by  incrementing  the  stack  pointer  by  the  memory 
requirements  of  the  arguments  (8  bytes).  This  is  only  required  for  the  C  version  of 
the  routine.  The  Turbo  Pascal  vmion  performs  this  task  rm  its  own. 

After  calling  this  routine,  the  AssmHand  routine  returns  the  (Hocessw  registus  to 
the  stack  and  passes  control  to  the  caller  using  a  FAR  RET  instruction. 

The  AssmHand  instructions  execute  very  quickly,  but  the  handler  itself  may  require 
more  execution  time  than  expected.  This  introduces  the  problem  of  recursion,  since 
an  event  in  connection  with  the  mouse  may  recur  during  the  handler  execution. 
The  AssmHand  drivo'  then  must  be  recalled  before  the  previous  call  traminated. 

To  avoid  this  situation  and  the  complications  which  can  occur,  AssmHand 
maintains  a  variable  named  active  in  its  code  segment.  During  execution  this 
variable  crmtains  the  value  1.  Befwe  setting  this  variable,  the  program  tests  if 
active  already  contains  the  value  1.  This  indicates  that  the  last  call  was  not  yet 
completed.  If  this  situation  occurs,  the  handler  execution  terminates  immediately, 
thus  avoiding  recursion. 

Even  if  this  method  avoids  recursion  problems,  remember  that  it  can  jvoduce  its 
own  problems.  The  suppression  of  the  higher  level  language  handler  does  not  take 
note  of  the  event,  b^ause  the  handler  was  not  called  by  the  mouse  driver. 
Although  we  offer  the  recursion  trap  as  an  option,  we  recommend  that  you 
program  the  highw  level  language  han^a  as  efficiently  as  possible  to  avoid  using 
processor  time.  This  will  keep  call  suppression  to  a  minimum. 

AssmHand  must  first  be  installed  through  function  OCH,  using  the 
MouISetEventHandler  jHOcedure/function.  MouISetEvoitHandlo’  is  called  by  the 
Moulnit  procedure/function,  which  initializes  the  mouse  module.  This  should  be 
called  by  any  application  program  as  the  first  procedure/function  of  this  module. 
The  number  of  lines  and  columns  of  the  display  screen  must  be  passed  to  it  as 
arguments,  to  determine  the  size  of  an  internal  buffer  needed  for  the  various 
procedure/functions  within  the  module. 

This  buffer  allows  division  of  the  screen  into  individual  mouse  ranges,  each 
equipped  with  its  own  code,  cursor  mask  and  screen  mask.  These  mouse  regkms 
are  very  important  in  mouse  access.  They  pomit  the  definition  of  objects  such  as 
slidoa,  O.K.  buttons  or  menu  items.  As  soon  as  the  user  moves  the  pointer  to  and 
object  and  presses  a  mouse  button,  the  object  executes  a  particular  step  in  the 
program. 
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MouDefRange  defines  these  regions.  The  registration  of  these  regions  occurs 
through  the  inxx^edure/function  MouDefRange,  which  must  receive  a  pointa*  to  a 
vector  or  array,  and  the  number  of  elements  stored  there.  These  elements  of  the 
type  RANGE  describe  a  screen  area  and  the  curscv  or  screra  mask  assigned  to  the 
pointo*  as  soon  as  it  reaches  this  area.  An  area  can  comprise  a  single  character  or 
the  total  screen.  The  user  can  define  the  array  with  individual  area  descripttxs.  The 
area  code  depends  on  the  position  of  the  descriptor  within  the  airay,  and  is  provided 
automatically  by  the  procedur^unction  MouDefRange.  The  first  area  has  the  value 
0,  the  second  the  value  1,  etc.  The  screen  areas  not  covered  by  an  area  deso^tor  are 
assigned  the  code  NO_RANGE. 

During  the  creation  of  this  array,  especially  during  the  definition  of  the  cutsot  and 
screenmask  in  the  PtrMask  array,  the  C  implementation  provides  helpful  macros 
and  constants.  The  Pascal  program  has  functions  and  constants  available  for  this 
purpose.  The  creation  of  a  variable  of  the  type  PTRVIEW,  stored  in  the  PtrMask 
field  within  an  area  descriptor,  is  handled  by  the  macro  or  function  MouPtrMask. 
The  cursor  and  screen  mask  for  the  character  must  be  passed  to  MouPtrMask  to 
define  the  pointo’s  tq)pearance  on  the  screen. 

If  PtrSameChar  is  indicated,  the  pointer  t^ipears  as  the  charact^  which  it  covo^.  If 
another  pointa  is  desired,  the  pointer  can  be  defined  with  PtrDifChar.  When  the 
call  occurs,  enter  the  ASCII  code  of  the  desired  chaiacto'  fw  PtrDifChar. 

As  a  second  parameter  MouPtrMask  gets  the  pointer's  color  from  the  cursor  mask 
and  screen  mask.  Many  options  for  color  are  possible: 

•  PtrSameCol  ensures  that  the  pointer  assumes  the  color  of  the  character 
currently  overi^)ped  by  the  pointa*. 

•  PtrSameColB  creates  a  pointer  which  assumes  the  color  of  the  character 
currently  overlapped.  However,  bit  7  of  the  attribute  byte  is  set  to  1  so 
that  the  character  either  blinks  or  appears  with  a  high-intensity 
background  cola*. 

•  PtrInvCol  makes  the  pointer  appear  in  the  inverse  color  of  the  character 
currently  overlapped  by  the  pointer. 

•  PtrDifCol  displays  the  pointer  on  the  screen  in  the  color  indicated  by  the 
code  following  I^DifCol. 

In  addition  to  the  different  mouse  areas  specified  through  MouDefRange,  a  pointer 
can  be  assigned  to  the  remaining  screen,  which  is  the  area  carrying  the  code 
NO_RANGE.  A  program  can  use  MouSetDefaultPtr  to  obtain  the  cursor  and 
screen  mask  of  the  points  as  a  parameter  of  type  PTRVIEW.  The  constants  and 
macros  w  functions  described  above  can  be  used  to  create  this  parameter. 

The  MouEventHandln  changes  the  cursw  and  screen  mask  for  each  area.  Since  it  is 
called  for  every  mouse  event  (including  mouse  movement),  it  can  determine  the 


628 


Abacus 


14.  Mouse  Programming 


mouse  area  where  the  pointer  is  currently  located.  To  make  this  happen  as  fast  as 
possible,  it  tests  if  the  mouse  area  contains  the  position  of  the  pointo'. 

MouEventHandler  uses  the  internal  regirni  buffer  which  was  created  by  Moulnit 
during  the  call.  It  reflects  exactly  the  video  RAM  structure,  and  contains  one  byte 
for  evoy  screen  position.  Each  byte  contains  the  code  of  the  area  to  which  the 
screen  position  was  assigned.  The  event  handler  can  use  the  current  position  of  the 
pointer  as  an  index  to  this  area  buffer.  A  single  memory  access  is  enough  to 
detomine  the  mouse  area  in  which  the  pointo^  is  located.  The  area  code  found  is 
sUxed  in  the  global  variable  MouRng,  and  is  used  as  an  index  to  the  array  of  the 
mouse  descriptor  from  which  it  detomines  the  cursor  and  screen  mask  for  this  area. 

The  higher  level  language  event  handler  has  another  assignment  which  may  be 
even  more  important  It  controls  the  variable  MouEvent  in  which  the  current 
mouse  evrats  are  stored.  This  task  cannot  be  performed  by  simply  copying  the 
mouse  events  which  were  passed  through  AssmHand  from  the  mouse  drivo'.  This 
only  shows  the  current  event,  but  no  preceding  evoits.  If  the  user  presses  and  holds 
the  left  mouse  button,  then  presses  the  right  mouse  button,  this  results  in  two 
event  handler  calls.  This  signals  each  case  of  an  active  mouse  button.  The 
preceding  call  (the  active  left  mouse  button)  is  no  longer  recognized  by  the  call, 
since  it  reports  only  the  current  event  (the  dejxessed  right  mouse  button). 

The  event  handler  must  isolate  the  various  events  which  are  reflected  in  the 
EvFlags  variable,  and  accept  only  new  events  in  the  MouEvent  variable.  This 
variable  reflects  the  current  status  of  the  mouse  buttons,  and  the  pointer's  current 
movement  or  position.  MouEvent  can  handle  the  most  important  mouse  sensing 
tasks,  waiting  for  the  occurrence  of  a  certain  event  (usually  a  pressed  mouse 
button). 


MouEventWait  waits  for  the  occurrence  of  an  event  which  was  specified  by  the 
bitmask  that  was  passed  earlier.  This  bitmask  can  be  defined  through  the  logical 
OR  function  with  the  following  constants: 


EV_MOU_MOVE 

EV_LEFT_PRESS 

EV_LEFT_REL 

EV_RIGHT_PRESS 

EV_RIGHT_REL 


Mouse  movement 
Left  mouse  button  pressed 
Left  mouse  button  released 
Right  mouse  button  pressed 
Right  mouse  button  released 


The  procedure/function  can  be  instructed  to  wait  for  one  or  more  of  these  evoits  to 
occur.  The  AND  or  OR  correspond  to  the  logical  comparisons  of  the  same  names. 
Which  events  occur  can  be  sensed  through  the  results  of  a  bitmask  in  which  the 
individual  bits  represent  the  various  events,  and  through  which  the  constants 
described  above  can  be  sensed. 
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Pascal  listing:  MOUSEP.PAS 

^ *★*★**★**★ ************************************************************ j 


{*  MOUSEP.PAS  *} 

(* - *j 

{*  Task  :  Demonstrate  the  different  functions  available  *) 

{*  in  mouse  programming 

(* - *j 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  Developed  on  :  04/21/1989  *} 

{*  Last  update  :  06/01/1989  *) 

I**********************************************************************  j 

uses  Dos;  {  Add  DOS  unit  } 

{$L  c:\tp\mousepa}  {  Link  assoid^ler  module  } 

{  adjust  path  to  your  systm  needs  } 
{=-  Declaration  of  external  functions  } 

{ $F+ }  {  far  function  } 

procedure  AssmHand  ;  external  ;  {  Assembler  event  handler  } 

{$F-}  {  FAR  functions  no  longer  accessible  } 


const 

{ —  Event -Codes - } 


EV_MOU  MOVE 

1 

{  Mouse  movement 

EV  LEFT  PRESS 

2 

{  Left  mouse  button  pressed 

EV  LEFT  REL 

4 

{  Left  mouse  button  released 

EV  RIGHT  PRESS 

* 

8 

{  Right  mouse  button  pressed 

EV_RIGHT  REL 

16 

{  Right  mouse  button  released 

EV_MOU_ALL 

* 

31 

{  All  mouse  events 

LBITS 

6 

{  EV  LEFT  PRESS  or  EV  LEFT__REL 

RBITS 

=* 

24 

{  EV_RIGHT_PRESS  or  EV_RIGHT_REL 

NO_RANGE 

255, 

{  Mouse  pointer  not  in  range  } 

PtrSameChar 

$00ff, 

{  Same  character 

PtrSameCol 

= 

$00ff 

{  Same  color 

PtrInvCol 

$7777, 

{  Inverse  color 

PtrSameColB 

= 

$807f 

{  Same  color,  blinking 

PtrlnvColB 

= 

$F777, 

{  Inverse  color,  blinking 

EAND 

0; 

{  Event  conparisons  for  MouEventWait 

EVOR 

= 

1; 

CRLF 

=  #13#10;  {  CR/LF 

{==  Type  declarations 


) 


type  FNCTPTR  =  longint; 

PTRVIEW  =  longint; 

RANGE  =  record 

xl, 

yi, 

x2, 

y2  :  byte; 

PtrMask  :  PTRVIEW; 
end; 

RNGARRAY  -  array  [0..100]  of  RANGE; 
RNGPTR  =  ^RNGARRAY; 

PTRREC  -  record 

Ofs  :  word; 

Seg  :  word; 
end; 


{  Address  of  a  FAR  function  } 
{  Mask  for  mouse  pointer  } 
{  Describes  a  mouse  range  ) 
{  Upper  left  and  lower  } 
{  right  coordinates  for  the  } 
{  specified  range  } 

{  Mask  for  mouse  pointer  } 


{  Allows  access  to  any  } 
{  mouse  pointer  record  } 
{  existing  } 
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PTRVREC 


RNGBUF 

BBPTR 


-  record  {  Allows  access  to  } 

ScreenMasJc  ;  word;  (  PTRVIEW  } 

CursorMask  :  word; 
end; 

-  array  [0.. 10000]  of  byte;  {  Range  buffer  } 

-  ''RNGBUF;  {  Pointer  to  a  range  buffer  } 


{—  global  variables  — - 

var  NumRanges, 

TLlne, 

TCol  :  byte; 

MouAvall  :  boolean; 

OldPtr, 

StdPtr  ;  PTRVIEW; 

BufPtr  :  BBPTR;  { 

ActRngPtr:  RNGPTR; 

BLen  :  Integer; 

ExltOld  :  pointer; 


{  Number  of  ranges  } 
{  Number  of  text  lines  ] 
{  Number  of  text  columns  } 
{  TRUE  If  mouse  Is  available  } 
{  Old  mouse  pointer  appearances  } 
{  Mask  for  standard  mouse  pointer  } 
Pointer  to  range  recognition  buffer  } 
{  Pointer  to  current  range  vector  } 
{  Range  buffer  length  In  bytes  } 
{  Pointer  to  old  exit  procedure  } 


{ —  Variables  which  are  loaded  Into  mouse  handler  on  every  call  — } 


MouRng, 

MouCol f 

MouRow  ;  byte; 
MouEvent  :  Integer; 


{  Current  mouse  range  } 
{  Mouse  column  (text  screen)  } 
{  Mouse  line  (text  screen)  } 
{  Event  mask  } 


( —  Variables  which  load  with  any  occurrence  of  expected  events  -} 

EvRng,  {  Range  In  which  the  mouse  can  be  found  } 
EvCol,  {  Mouse  column  } 
EvRow  :  byte;  {  Mouse  line  } 


f  ********************************************************************** } 


{*  MouPtrMask:  Executes  Cursor-Mask  and  Screen-Mask  from  a  bitmap  *} 
containing  character  and  color 

_ ★★  j 

[*  Input  :  Chars  »  Bitmask  of  character  as  found  In  Cursor-Mask  *} 
(*  and  Screen-Mask  *) 

(*  Color  -  Bitmask  of  character  color  as  found  In 

(*  Cursor-Mask  and  Screen-Mask  *} 

(*  Output  :  Cursor-Mask  and  Screen-Mask  as  a  value  of  typ  PtrVlew  *} 
{*  Info;  The  constants  PtrSameChar,  PtrSameCol,  PtrSameColB, 


{*  PtrInvCol,  PtrlnvColB,  and  the  results  of  the  PtrDlfChar 

(*  and  PtrDlfCol  functions  also  control  character  &  color 

{**********************★**************«*****************************★**  j 


function  MouPtrMask (  Chars,  Color  :  word  )  :  PTRVIEW; 
var  Mask  :  PTRVIEW;  {  For  creating  Cursor-Mask  and  Screen-Mask  } 

begin 

PTRVREC (  Mask  ) .ScreenMask 

PTRVREC (  Mask  ) .CursorMask 
MouPtrMask  Mask; 
end; 

{★***********★**«********************************************★*********  y 
(*  PtrDlfChar:  Defines  character  structure  of  cursor  and  screen 


{*  mask  In  conjunction  with  character  *} 

j** _ ★★  j 

{ *  Input  ;  ASCII  code  of  the  character  on  which  pointer  Is  based  * } 

{*  Output  :  Cursor  and  screen  mask  for  this  cursor  *} 

(*  Info;  Function  result  should  be  confuted  with  the  help  of  the 
(*  MouPtrMask  function  *} 


^** ******** ****************************** ******* **************** *******  j 

function  PtrDlfChar (  Chars  :  byte  )  ;  word; 


(  (  Color  and  $ff  )  shl  8  )  + 

(  Chars  and  $ff  ); 

:»  (  Color  and  $ff00  )  +  (  Chars  shr  8  ); 

{  Return  mask  to  caller  } 
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begin 

PtrDifChar  Chars  shl  8; 
end; 


{*  PtrDifCol:  Creates  the  character  segment  of  the  cursor  and  screen  *} 


i*  mask  in  conjunction  with  the  mouse  pointer  color  *} 

{ - - - - - - - - - ) 

{*  Input  :  Character  color  on  which  the  mouse  pointer  will  be  based  *} 
{★  Output  :  cursor  and  screen  mask  for  this  color 

Info;  The  function's  result  should  be  computed  with  the  help 
{*  of  the  MouPtrMask  function  *} 


function  PtrDifCol (  Color  :  byte  )  ;  word; 
begin 

PtrDifCol  Color  shl  8; 
end; 


^**  ****************************  Itlfklfk  ************** -Ifk-lftfltltifkifkltifk -kit-kit*  ***  ^ 

{*  MouDeflnePtr:  Assigns  the  mouse  driver  the  cursor  mask  and  *} 


i*  screen  mask,  from  which  the  driver  can  create  the  *} 

{*  mouse  pointer  *} 

{** - **) 

{*  Input  ;  Mask  *  The  cursor  and  screen  mask  as  a  parameter  of 
{*  type  PTRVIEW  *} 

{*  Info:  -  The  mask  parameter  should  be  created  with  the  help  of  *} 

{*  the  MouPtrMask  function 

{*  -  The  most  significant  16  bits  represent  the  screen  mask,*} 

{*  the  least  significant  16  bits  represent  cursor  mask  *} 


^  ****** ****** ************************************** ***************** I 


procedure  MouDeflnePtr (  Mask  ;  PTRVIEW  ); 


var  Regs  :  Registers; 


{  Processor  regs  for  Interrupt  call  } 


begin 

If  OldPtr  <>  Mask  then 
begin 

Regs. AX  :»  $000a; 
Regs.BX  ;=  0; 
Regs.CX  PTRVREC( 
Regs.DX  PTRVREC ( 
Intr(  $33,  Regs) ; 
OldPtr  Mask; 
end; 

end; 


{  Mask  change  since  last  call?  } 
{  YES  } 

{  Funct.  no.  for  "Set  text  pointer  type"  } 
{  Create  software  pointer  } 
Mask  ) .ScreenMask;  {  Low-word  Is  AND  mask  } 
Mask  ) .Cursoztfask;  {  Hlgh-word  1st  XOR  mask  } 
{  Call  mouse  driver  } 
{  Reserve  new  bitmask  } 


^  **********************************************************************  j 

{♦  MouEventHandler:  Called  by  the  assembler  routine  AssmHand  as  soon  *} 


as  a  mouse  event  occurs 

{*  Input  :  EvFlags  “  The  event  mask  ’‘} 

{*  ButState  =  Current  mouse  button  status 

{*  X,  Y  =  Current  coordinates  of  the  mouse  pointer  on  * } 

the  text  screen  ^} 

^  **********************************************************************  j 


procedure  MouEventHandler (  EvFlags,  ButState,  x,  y  :  Integer  ) ; 

var  NewRng  :  byte;  {  Number  of  new  range  } 

iDegln 

MouEvent  ;=  MouEvent  and  not (1) ;  {  Bit  0  excluded  } 

MouEvent  :=  MouEvent  or  (  EvFlags  and  1  );  1  Bit  0  copied  } 

If  (  EvFlags  and  LBITS  )  <>  0  then  {  Lft  button  released  or  pressed?  } 
begin  {  YES  } 
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MouEvent  MouEvent 

MouEvent  MouEvent 

end; 

if  (  EvFlags  and  RBITS  ) 
begin 

MouEvent  MouEvent 
MouEvent  ;*  MouEvent 
end; 


and  not (  LBITS  ) ;  {  Remove  previous  status  } 

or  (  EvFlags  and  LBITS  );  {Add  status  } 

<>  0  then  {  Rgt  button  released  or  pressed?) 

{  YES  ) 

and  not (  RBITS  ) ;  {  Remove  previous  status  } 

or  (  EvFlags  and  RBITS  );  {  Add  status  ) 


MouCol  x;  {  Convert  columns  to  text  columns  } 

MouRow  y;  {  Convert  lines  to  text  lines  ) 

{ —  Determine  range  in  which  the  mouse  should  be  found  and  - ) 

{ —  determine  whether  range  has  changes  since  the  previous  call  - ) 

{ —  of  the  handler.  If  so,  the  cursor  image  must  be  redefined.  - } 


NewRng  :»  BufPtr'^t  MouRow  *  TCol  +  MouCol  ]; 
if  NewRng  <>  MouRng  then 
begin 

if  NewRng  -  NO_RANGE  then 
MouDef InePtr (  StdPtr  ) 
else 


{  Get  range  } 
{  New  range?  } 
{  YES  ) 

{  Outside  of  a  range?  ) 
{  YES,  standard  pointer  } 
{  NO,  range  recognized  } 


end; 

MouRng 

end; 


MouDef inePtr (  ActRngPtr^[  NewRng  ] .PtrMask  ); 


NewRng; 


{  Reserve  range  number  in  global  variable  } 


^ *************************************************************** *******} 


{*  MouIBufFlll:  Store  the  code  for  a  mouse  range  within  the  *) 

{*  modulare  range  memory 

(** - - **) 

{*  Input  :  xl,  yl  -  UK»r  left  comer  of  the  mouse  range  *) 

{*  x2,  y2  -  Lower  right  corner  of  the  mouse  range 

{*  Code  *  Range  code  *) 


{**********************************************************************} 


procedure  MouIBufFlll (  xl,  yl,  x2,  y2.  Code  :  byte  ); 


var  Index  :  Integer; 

Column, 

Line  :  k^e; 
begin 

for  Llne:=yl  to  y2  do 
begin 

Index  Line  *  TCol  +  xl; 
for  Column: -xl  to  x2  do  {  i 
begin 

BufPtr^t  Index  ]  :»  Code; 
lnc(  Index  ); 
end; 

end; 

end; 


{  Points  to  array  ) 
{  Loop  counter  } 


{  Count  individual  lines  ) 

{  First  line  index  ) 
through  the  columns  in  this  line  ) 

{  Save  code  ) 
{  Set  index  to  next  array  } 


{********************************************************************** j 

{*  MouDefRange:  Allows  the  registration  of  different  screen  ranges,*) 


{*  which  the  mouse  recognizes  as  different  ranges.  *) 
{*  The  mouse  pointer's  appearance  changes  when  it  *) 
{*  senses  each  range  *) 

(** - - - **) 

{*  Input  :  Number  »  Number  of  screen  ranges  *) 
{*  BPtr  »  Pointer  to  the  array  in  which  the  individual  *) 
{*  ranges  are  written  as  a  structure  of  type  *) 
{*  RANGE  *) 
{*  Info:  -  The  free  areas  of  the  screen  are  assigned  the  code  *) 
{*  NO_RANGE  *) 
{*  -  When  the  mouse  pointer  enters  one  of  the  ranges,  *) 
{*  tlie  mouse  range  calls  the  event  handler  *) 


{**********************************************************************} 
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procedure  MouDef Range (  Number  ;  byte;  BPtr  :  RNGPTR  ); 

var  ActRng,  {  Number  of  the  current  range  ) 

Range  :  byte;  {  Loop  counter  } 

begin 

ActRngPtr  :*  BPtr;  { 

NuroRanges  :«  Number; 

FlllChar(  BufPtr'^,  BLen,  NO_RANGE  ); 
for  Range :»0  to  Number-1  do  { 

with  BPtr*^  [  Range  ]  do 

MouIBufFill(  xl,  yl,  x2,  y2,  Range  >; 


{ —  Redefine  mouse  pointer - 1 

ActRng  :»  BufPtr'^[  MouRow  *  TCol  +  MouCol  ];  {  Get  range  } 

if  ActRng  -  NO_RANGE  then  {  Outside  a  range?  } 


MouDef inePtr (  StdPtr  )  {  YES,  standard  pointer  } 

else  {  NO,  range  recognized  } 

MouDef inePtr  (  BPtr-^E  ActRng  ]  .PtrMask  ); 

end; 

I **★★*★**★★ ★★*★★**★★★*★★★★★★★**★*****★*** ****★*★*★*★*★***★*★***★ *★*★***} 

{*  MouEventWait :  Waits  for  a  specific  mouse  event  *} 


- **) 

{*  Input  :  TYP  *  Type  of  ccanparison  between  different  events  *} 
{*  WAIT_EVENT  «  Bitmask  which  specifies  the  awaited  event  *} 
{*  Output  :  Bitmask  of  the  occurring  event  *} 
{*  Info:  -  WAIT_EVENT  can  be  used  in  conjunction  with  OR  for  other*} 
{*  constants  like  EV_MOU_MOVE,  EV_LEFT_PRESS  etc.  *} 
{*  -  Ccanparison  types  can  be  given  as  AND  or  OR.  If  AND  is  *} 
{*  selected,  the  function  returns  to  the  caller  if  all  *} 
{*  anticipated  events  occur.  OR  returns  the  function  to  *} 
{*  the  caller  if  at  least  one  of  the  events  occurs.  *} 


^**********************************************************************} 

function  MouEventWait (  Typ  :  BYTE;  WaitEvent  :  Integer  )  :  integer; 

var  Act Event  :  integer; 

Line, 

Column  :  byte; 

CEnd  :  boolean; 

begin 

Column  :=  MouCol;  {  Reserve  current  mouse  position  } 

Line  :=  MouRow; 

CEnd  false; 


Reserve  pointer  to  vector  } 
{  and  number  of  ranges  } 
{  All  element s-NOJRANGE  } 
Check  out  different  ranges  } 


repeat 

{ —  Wait  for  one  of  the  events  to  occur 


-} 


if  Typ  =  EAND  then 
repeat 

Act Event  ;=  MouEvent; 
until  ActEvent  =  WaitEvent 
else 
repeat 

ActEvent  :»  MouEvent; 


until  (  ActEvent  and  WaitEvent  )  <>  0; 


{  AND  comparison?  } 
{  YES,  all  events  must  occur  } 
{  Get  current  event  } 

{  OR  ccxnparison  } 
{  At  least  one  event  must  occur  } 
{  Get  current  event  } 


ActEvent  :*  ActEvent  and  WaitEvent;  {  Check  event  bits  only  } 

{ —  While  waiting  for  mouse  movement,  the  event  is  accepted  —  } 

{ —  nonly  if  the  mouse  pointer  moves  to  another  line  and/or  —  } 

{ —  column  in  the  text  screen  -  } 

if  (  (  (WaitEvent  and  EV_M0U_M0VE)  <>  0  )  and 

(  Column  *  MouCol  )  and  (  Line  »  MouRow  )  )  then 
begin  {  Mouse  moved,  but  still  at  the  same  screen  position  } 

ActEvent  :»  ActEvent  and  not (  EV_MOU_MOVE  >;  {  Move  bit  out  } 

CEnd  :*  (  ActEvent  <>  0) ;  {Still  waiting  for  events?  } 


634 


Abacus 


14,  Mouse  Programming 


end 

else  (  Event  occurs  } 

CEnd  TRUE; 
until  CEnd; 

EvCol  :»  MouCol; 

EvRow  MouRow; 

EvRng  MouRng; 

MouEventWalt  :»  Act Event; 
end; 

^ ★*★**★*★*★*★****★*★****★*★*★****★***★*************★*★♦*♦*****★******** j 


{*  Mbul Set Event Handler:  Installs  an  event  handler  which  is  called 
{*  when  a  particular  mouse  event  occurs. 

(** - **} 

{*  Input  :  EVENT  »  Bitmask  which  describes  the  event,  called  *} 

i*  through  an  event  handler  *} 

{*  FPTR  »  Pointer  to  the  event  handler  of  type  FNCTPTR 

{*  Info:  -  EVENT  can  be  used  through  OR  conparisons  in  conjunc-  *} 

{*  tion  with  constants  like  EV_MOU_MOVE,  EV_LEFT_PRESS  etc*} 

{*  -  The  event  handler  must  be  a  FAR  procedure,  and  change  *} 

{*  none  of  the  given  processor  registers  *} 


I ★*★****★★* ******* **★★***★ ************************************** *******  j 

procedure  Moul Set Event Handler {  Event  :  integer;  FPtr  :  FNCTPTR  ); 

var  Regs  :  Registers;  {  Processor  regs  for  interrupt  call  } 

begin 

Regs. AX  :*»  $000C;  {  Funct.  no.  for  "Set  Mouse  Handler"  } 

Regs.CX  :»  event;  {  Load  event  mask  } 

Regs.DX  :=  PTRREC(  FPtr  ) .Ofs;  {  Offset  address  of  handler  } 

Regs.ES  :=  PTRREC(  FPtr  ) .Seg;  {  Segment  address  of  handler  } 

Intr(  $33,  Regs  );  {  Call  mouse  driver  } 

end; 

^ ********************************************************************** j 

{*  MouIGetX:  Returns  the  text  column  in  which  the  mouse  pointer  can  *} 


{*  be  found  *} 

^  ** _ ** } 

{*  Output  :  Mouse  column  converted  to  text  screen  *} 


^  **********************************************************************  j 

function  MouIGetX  :  byte; 

var  Regs  :  Registers;  {  Processor  regs  for  interrupt  call  } 

begin 

Regs. AX  :=  $0003; 

Intr(  $33,  Regs  ); 

MouIGetX  :=  Regs.CX  shr  3; 
end; 

I**********************************************************************  j 


{*  MouIGetY:  Returns  the  text  line  in  which  the  mouse  pointer  can  *} 
{*  be  found  *} 

I** - - - **} 

{*  Output  :  Mouse  line  converted  to  text  screen  *} 


^  **********************************************************************  j 

function  MouIGetY  :  byte; 

var  Regs  :  Registers;  {  Processor  regs  for  interrupt  call  } 

begin 

Regs. AX  :=  $0003; 

Intr(  $33,  Regs  ); 

MouIGetY  :=  Regs.DX  shr  3; 
end; 


{  Funct.  no.  for  "Get  mouse  position"  } 
1  Call  mouse  driver  } 
{  Convert  column  and  return  new  value  } 


{  Determine  current  mouse  position  } 
(  and  range  in  global  } 
{  variables  } 


{  Funct.  no.  for  "Get  mouse  position"  ) 
{  Call  mouse  driver  } 
{  Convert  line  and  return  new  value  } 
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I **********************************************************************  j 


{*  MouShowMouse:  Show  mouse  pointer  on  the  screen  *} 

{** - **) 

Info:  Calls  between  MouShowMouse  and  MouHideMouse  must  be  evenly  *} 
{ *  balanced  * } 


I********************************************************************** } 


procedure  MouShowMouse; 
var  Regs  :  Registers; 
begin 

Regs. AX  $0001; 

Intr(  $33,  Regs  ); 
end; 


Processor  regs  for  Interrupt  call  ) 

{  Funct.  no.  for  “Show  Mouse"  } 
{  Call  mouse  driver  } 


I**********************************************************************} 

{*  MouHideMouse:  Hide  mouse  pointer  from  the  screen  *} 

{** - **) 

(*  Info:  Calls  between  MouShowMouse  and  MouHideMouse  must  be  evenly  *} 
{ *  balanced  * } 

I**********************************************************************  j 

procedure  MouHld^fouse; 

var  Regs  :  Registers;  {  Processor  regs  for  Interrupt  call  } 

begin 

Regs. AX  :=  $0002;  {  Funct.  no.  for  "Hide  Mouse"  } 

Intr(  $33,  Regs);  {  Call  mouse  driver  } 

end; 


{ ***★★★******★★***★★★***★★★****************★***************************} 
MouSetMoveArea :  Specify  movement  range  for  mouse  pointer  *} 


I  ** _ _ _ **} 

{*  Input  :  xl,  yl  =  Coordinates  of  range's  upper  left  corner  *} 
{*  x2,  y2  “  Coordinates  of  range's  lower  right  comer  *} 
{*  Info:  -  The  coordinates  Indicate  the  text  screen  coordinates,  *} 
{*  and  not  the  virtual  graphic  screen  used  by  the  mouse  *) 
{*  driver  *} 


I********************************************************************** j 

procedure  MouSetMoveArea  (  xl,  yl,  x2,  y2  :  byte  ) ; 

var  Regs  :  Registers;  {  Processor  regs  for  Interrupt  call  } 


begin 


Regs. AX  :*  $0008; 

{  Funct. 

no.  for  "Set  vertical  limits" 

Regs.CX  :=  Integer (  yl  ) 

shl  3; 

{  Conversion  to  virtual 

Regs.DX  :*  Integer (  y2  ) 

shl  3; 

{  mouse  screen 

Intr(  $33,  Regs  ); 

{  Call  mouse  driver 

Regs. AX  :-  $0007; 

{  Funct.  no 

.  for  "Set  horizontal  limits" 

Regs.CX  :»  Integer (  xl  ) 

shl  3; 

{  Conversion  to  virtual 

Regs.DX  :-  Integer (  x2  ) 

shl  3; 

{  mouse  screen 

Intr(  $33,  Regs  ); 

{  Call  mouse  driver 

end; 


I *★★★★*«★★★★*★***★★★********★*******★«************★★****★**************} 


{*  MouSetSpeed:  Configures  movement  speed  of  mouse  pointer  *} 

(** - - - **} 

{*  Input  :  XSpeed  =  Speed  In  X-dlrectlon  *} 

{*  YSpeed  =  Speed  In  Y-dlrectlon  *} 

{*  Info:  -  Parameters  are  measured  In  units  of  *} 

{*  mlckeys  (8  per  pixel)  *} 


^ *★**★*★*★**★**********★★★★******★★★★****★★★★★**★*★★**★★★**★★*★★ ★★*★***  j 

procedure  MouSetSpeed (  XSpeed,  YSpeed  :  Integer  ); 

var  Regs  :  Registers;  {  Processor  regs  for  Interrupt  call  } 
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begin 

Regs. AX  $000f;  {  Funct.  no.  for  “Set  miclceys  to  pixel  ratio"  } 

Regs.CX  XSpeed; 

Regs.DX  YSpeed; 

Intr(  $33,  Regs);  {  Call  mouse  driver  } 

end; 


I ***************** **************** ******* *********************** ******* } 


{*  MouMovePtr:  Moves  mouse  pointer  to  a  specific  position  on  the  *} 
{ *  screen  * ) 

(** - **} 

Input  :  COL  -  New  screen  column  for  mouse  pointer  *1 

{*  RCW  «  New  screen  line  for  mouse  pointer  *} 

{*  Info;  -  The  coordinates  indicate  the  text  screen,  and  not  the  *} 

{*  virtual  graphic  screen  used  1:^  the  mouse  driver  *} 


^ *************************************************************** *******} 
procedure  MouMovePtr (  Col,  Row  ;  byte  ) ; 

var  Regs  ;  Registers;  {  Processor  regs  for  interrupt  call  } 

NewRng  :  byte;  {  Range  into  which  the  mouse  is  moved  } 


begin 

Regs. AX  $0004; 

MouCol  :*  col; 

MouRow  row; 

Regs.CX  integer (  col  )  shl  3; 
Regs.DX  :*  integer (  row  )  shl  3; 
Intr{  $33,  Regs  ); 


I  Funct.  no.  for  "Set  mouse  pointer  position"  } 
{  Store  coordinates  in  } 
{  global  variables  } 
{  Convert  coordinates  and  store  } 
{  in  global  variables  } 
{  Call  mouse  driver  } 


NewRng  BufPtr''[  Row  *  TCol  +  Col 
if  NewRng  <>  MouRng  then 
begin 

if  NewRng  «  NO_RANGE  then 
MouDef inePtr (  StdPtr  ) 
else 


];  {  Get  range  } 

{  New  range?  } 
{  YES  } 

{  Outside  of  a  range?  } 
{  YES,  standard  pointer  ) 
{  NO,  range  recognized  } 


end; 

MouRng 

end; 


MouDef inePtr  (  ActRngPtr''[  NewRng  ]  .PtrMasJc  ); 


NewRng; 


{  Place  range  number  in  global  variable  } 


I  ********************************************************************** j 

{*  MouSetDefaultPtr:  Defines  default  pointer  af^arance  for  screen  *} 
{*  ranges  not  assigned  as  special  ranges  *} 

{*  Input  ;  Standard  »  Cursor  and  screen  mask  for  mouse  pointer  *} 

{*  Info;  -  The  parameters  should  be  created  with  the  help  of  the  *} 
{*  MouPtrMask  function  *} 

{********************************************************************** ^ 

procedure  MouSetDefaultPtr (  Standard  ;  PTRVIEW  ) ; 

begin 

StdPtr  ;=  Standard;  {  Reserve  bitmask  in  global  variable  } 

{ —  If  the  pointer  isn't  currently  in  a  range,  convert  to  default - } 

if  MouRng  «  NO_RANGE  then  {  No  range?  } 

MouDef inePtr (  Standard  ) ;  {  NO  } 

end; 

{ ********************************************************************** j 

{*  MouEnd:  End  the  mouse  module  functions  and  procedures  *} 

{*  Info;  -  This  procedure  doesn't  have  to  be  called  direct  from  the^} 
{*  application,  sinc«  the  Moulnit  function  defines  this  *} 

{*  as  the  exit  procedure  *) 

^ ********************************************************************** j 
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{$F+} 
procedure  MouEnd; 
var  Regs  :  Registers; 
begin 

MouHldeMouse; 

Regs. AX  :»  0; 

Intr(  $33,  Regs) ; 

FreeMem (  BufPtr,  BLen  ) ; 

ExltProc  :=  Exit Old; 
end; 

{$F-} 


{  must  be  FAR  to  allow  call  as  exit  procedure  } 


{  Processor  regs  for  Interrupt  call  } 

{  Hide  mouse  from  screen  } 
{  Reset  mouse  driver  } 
{  Call  mouse  driver  } 

{  Release  allocated  memory  } 

{  Restore  old  exit  procedure  } 

{  No  more  FAR  procedures  } 


{*  Moulnlt:  Initializes  mouse  functions  and  procedures  as  well  as  *} 
{*  variables  *} 

*} 
*} 

*} 
*) 
*} 


_ 

{ *  Input 
{* 

{ *  Output 
{*  Info: 


Columns  »  Number  of  screen  columns 
Lines  »  Number  of  screen  lines 
TRUE  If  a  mouse  driver  Is  Installed,  else  FALSE 
-  This  function  must  be  the  first  called  frcxn  an 
application  program,  before  other  procedures  and 
functions  can  be  called 


function  Moulnlt (  Columns,  Lines  :  byte  )  :  boolean; 


var  Regs  :  Registers; 
begin 

TLlne  :=  Lines; 

TCol  :=  Columns; 

ExltOld  :=  ExltProc; 

ExltProc  :»  @MouEnd; 

{ —  Allocate  and  fill  mouse  range 

BLen  :=  TLlne  *  TCol; 

GetMem (  BufPtr,  BLen  )  ; 


{  Processor  regs  for  Interrupt  call  } 


{  Store  number  of  lines  and  } 
{  columns  In  global  variables  } 

{  Set  address  of  exit  procedure  } 
{  Define  MouEnd  as  exit  procedure  } 


MouIBufFllK  0,  0,  TCol-1,  TLlne-1,  NO_RANGE  ); 


{  Number  of  characters  In  screen  } 
{  Allocate  Internal  range  buffer  } 


Regs. AX  :=  0; 

Intr(  $33,  Regs  ); 

Moulnlt  :=  (  Regs .AX  <>  0  ); 

MouSetMoveArea (  0,  0,  TCol-1,  TLlne-1  ); 


{  Initialize  mouse  driver  } 
{  Call  mouse  driver  } 
{  Mouse  driver  Installed?  } 

{  Set  move  area  } 


MouCol  :=  MouIGetX;  {  Load  current  mouse  position  } 
MouRow  :=  MouIGetY;  {  Into  global  variables  } 
MouRng  :=  N0_RANGE;  {  Pointer  In  no  set  range  } 
MouEvent  :=  Ey_LEFT_REL  or  EV_RIGHT_REL;  {  No  mouse  button  pressed  } 
StdPtr  :=  MouPtrMas)c(  PTRSAMECHAR,  PTRINVCOL  );  {  Std.  pointer  } 
OldPtr  :=  PTRVIEW(  0  ); 


{ —  Install  assembler  event  handler  "AssmHand'' - } 

MouISetEventHandler(  EV_MCXJ_ALL,  FNCTPTR  (@AssmHand)  ); 

end; 

I *★*****★★★ ★*★*★★★******** ★******★★★★********★★****★*★★★******** *★***★★★ 

*  MAINPROGRAM  * 

*********** ****************************** ******************************  j 


const  Ranges  :  array[0..4]  of  RANGE 


{  The  mouse  range  } 
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( 

xl: 

0; 

yi: 

0; 

x2: 

79; 

y2: 

0 

( 

xl: 

0; 

yl: 

1; 

x2: 

0; 

y2: 

23 

( 

xl: 

0; 

yi: 

24; 

x2: 

78; 

y2: 

24 

( 

xl: 

79; 

yl: 

1; 

x2: 

79; 

y2: 

23 

( 

xl: 

79; 

yl: 

24; 

x2: 

79; 

y2: 

24 

); 

var  Dummy  :  Integer; 


{  Top  line  } 
{  Left  column  } 
{  Bottcxa  line  ) 
{  Right  column  } 


{  Lower  right  corner  } 
{  Get  result  from  MouEventWait  } 


begin 

{ —  Configure  mouse  pointer  for  the  different  mouse  ranges - ) 

Ranges [  0  ] .PtrMask  :=  MouPtrMas)c(  PtrDifChar ($18) ,  PtrInvCol) ; 

Ranges [  1  ] .PtrMask  :=  MouPtrMask(  PtrDifChar ($lb) ,  PtrInvCol); 

Ranges [  2  ] .PtrMask  ; -  MouPtrMask (  PtrDifChar ($19) ,  PtrInvCol); 

Ranges [  3  ] .PtrMask  MouPtrMask(  PtrDifChar ($la) ,  PtrInvCol); 

Ranges [  4  ]. PtrMask  : -  MouPtrMask (  PtrDifChar ($58) ,  PtrDlfCol ($40) ) ; 

writeln (#13#10, ‘MOUSEP  -  (c)  1989  by  MICHAEL  TISCHER'#13#10) ; 

if  Moulnit  (  80,  25  )  then  {  Initialize  mouse  module  } 

begin  {  OK,  there's  an  installed  mouse  driver  } 

writelnCMove  the  mouse  pointer  around  the  screen.  As  you  move  ',CRLF, 

•it  around  the  edge  of  the  screen,  you  will  see  the  mouse ',CRLF, 
•pointer  change  its  ai^arance.  The  pointer  shape  changes  ',CRLF, 
•as  you  move  the  mouse  frcxn  edge  to  edge.  ',CRLF,CRLF, 

•To  end  this  program,  move  the  mouse  pointer  to  the  ',CRLF, 
•lower  right  comer  of  the  screen,  and  press  both  the  ',CRLF, 
•left  and  right  mouse  buttons  at  the  same  time.  *); 

MouSetDefaultPtr (  MouPtrMask(  PtrDifChar (  $DB  ),  PtrDifCol (  3  )  )  ); 
MouDef Range (  5,  @Ranges  );  {  Range  definition  } 

MouShovtf^ouse;  {  Display  mouse  pointer  on  the  screen  } 


{ —  Wait  until  the  user  presses  both  the  left  and  right  mouse  - } 

{ —  buttons  simultaneously  while  the  pointer  is  in  range  4  - } 


repeat  {  Read  loop  } 

Dummy  :=  MouEventWait (  EAND,  EV_LEFT_PRESS  or  EV_RIGHT_PRESS  ); 
until  EvRng  =  4; 
end 

else  {  No  mouse  installed  OR  no  mouse  driver  installed  } 

writeln (' Sorry,  no  mouse  driver  currently  installed.'); 

end. 


Assembler  listing:  MOUSEPA.ASM 


M  O  U  S  E  P  A 


r 

•  * 

Task 

:  Create  mouse  called  event 
a  Turbo  Pascal  program. 

handler  for  use  with  *; 

*. 

•  ★ 
f 

Author 

:  MICHAEL  TISCHER 

*• 

.  * 
r 

Developed  on 

:  04/24/1989 

*• 

•  * 

.  * _ 

Last  update 

:  04/24/1989 

;* 

assembly 

:  MASM  /MX  MOUSEPA;  or 

*  - 

-  * 

TASM  -MX  MOUSEPA; 

*• 

f 

.  * 

. . .  add  to  MOUSEP  program 

code  *; 

,  "  ...  aua  to  piLAOC.t'  program  coae  - ; 

.  **********  ******************■!(****  ******************************  ******** 


DATA  segment  word  public 

DATA  ends  ;note — no  variables  in  this  program 

CC»E  segit^nt  byte  public  ; Program  segment 
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assume  CS:CODE  ;CS  points  to  the  code  segment  whose 

; contents  are  unknown  to  DS,  SS  &  ES 

public  AssraHand  /Allows  the  TP  program  to  read 

/the  address  of  the  ass«nbler  handlers 

extrn  MouEvent Handler  :  near  /TP  event  handler  to  be  called 

active  db  0  /points  to  whether  a  call  can  occur 


/ —  AssmHand  :  The  event  handler  which  first  calls  the  mouse  driver,  then 
; —  calls  the  TP  MouEventHandler  procedure 

/ —  Direct  call  fran  TP  not  allowed 

AssmHand  proc  far 

/ —  First  save  all  processor  registers  on  stack  - 


cmp  active, 0 

/Call  done  yet? 

jne  ende 

/NO  — >  Don't  exit  call 

mov  active,! 

/No  more  calls,  please 

push  ax 

push  bx 

push  cx 

push  dx 

push  di 

push  si 

push  bp 

push  es 

push  ds 

/ —  Push  arguments  for  TP  function  call  onto  stack  - 

/—  Call: 

/ —  MouEventHandler  (EvFlags,  ButStatus,  x  ,  y  :  integer  )/ 


push 

ax 

/Push  event  flags  onto  stack 

push 

bx 

/Push  mouse  button  status  onto  stack 

mov 

di,cx 

/Move  horizontal  ordinate  onto  DI 

mov 

cl,  3 

/Counter  for  coordinate  number 

shr 

di,cl 

/Divide  DI  (horizontal  ord.)  by  8  and 

push 

di 

/push  onto  stack 

shr 

dx,  cl 

/Divide  DX  (vertical  ord.)  by  8  and 

push 

dx 

/push  onto  stack 

mov 

ax,  DATA 

/Segment  address  of  data  segment  AX 

mov 

ds,ax 

/Move  data  from  AX  to  DS  register 

call 

MouEventHandler 

/Call  TP  procedure 

/ —  Get  reserved  registers  from  stack  - 

pop 

ds 

pop 

es 

pop 

bp 

pop 

si 

pop 

di 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

mov 

active,© 

/Re-enable  call 
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ende:  ret  ; Return  to  mouse  driver 

AssmHand  endp 


CCXDE  ends  ;End  of  code  segment 

end  ;End  of  program 

C  listing:  MOUSEC.C 

/************★*****★*****************************************★*********/ 


/*  MOUSEC.C  */ 

- */ 

/*  Task  :  Demonstrates  mouse  access  from  the  C  language  * / 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  Developed  on  :  04/20/1989  */ 

/*  Last  update  :  06/14/1989  */ 

/* - */ 

/*  Microsoft  C  */ 

/*  Creation  :  CL  /AS  MOUSEC.C  MOUSECA.OBJ  */ 

/♦Call  :  MOUSEC  */ 

/*  Turbo  C  (integrated  system)  */ 

/*  Creation  :  Create  a  project  file  containing  the  following:*/ 

/*  MOUSEC  */ 

/*  MOUSECA.OBJ  */ 

/*  Make  sure  that  memory  model  is  set  to  small.  */ 

/*  If  you  didn't  assemble  the  MOUSECA.ASM  file  */ 

/*  using  the  /MX  option  in  MASM,  make  sure  that  */ 

/*  Case-Sensitive  Link  on  Linker  options  is  OFF.  */ 

/*  Disable  stack  checking  before  COTipilation.  */ 

/*  »NOTE:  One  warning  will  occur  (about  the  */ 

/*  But St ate  in  the  MouEvent Handler  function) .  */ 

/*  The  program  will  run.  Do  NOT  remove  */ 

/*  the  ButState  declaration  -  the  AssmHand  routine*/ 

/*  needs  it«  */ 

/*  Call  :  MOUSEC  */ 

/****** -k-k-k-k-k-k  ***********  **-k  ********************************************  / 

/*==  Add  Include  files  «======*==**«**=====*=*x=*****«=«=**«====*=====*/ 


♦include  <dos.h> 
♦include  <stdlib.h> 


extern  void  far  AssmHand (  void  ); 

typedef  unsigned  char  BYTE; 
typedef  unsigned  long  PTRVIEW; 
typedef  struct  { 

BYTE  xl, 

yi, 

x2, 

y2; 

PTRVIEW  ptr_mask; 

}  RANGE; 

typedef  void  (far  *  MOUHAPTR) (  void 


/*  External  declaration  */ 
/*  of  assembler  handler  */ 

/*  Create  a  byte  */ 
/*  Mouse  pointer  mask  */ 
/*  Describe  a  mouse  range  */ 
/*  Upper  left  coordinates  of  the  */ 
/*  specified  range  */ 

/*  Lower  right  corner  of  the  */ 
/*  specified  range  */ 

/*  Mouse  pointer  mask  */ 

);  /*  Pointer  to  event  handler  */ 


/*==  Constants 


'*/ 


♦define  TRUE  (  i  ==  l  ) 

♦define  FALSE  (  l  ==  0  ) 

/* —  Event  codes - */ 


♦define  EV  MOU  MOVE  1 


/*  Move  mouse  */ 
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♦define  EV_LEFT_PRESS  2 
♦define  EV_LEFT_REL  4 
♦define  EV_RIGHT_PRESS  8 
♦define  EV_RIGHT_REL  16 
♦define  EV  MOU  ALL  31 


/*  Left  mouse  button  pressed  */ 
/*  Left  mouse  button  released  */ 
/*  Right  mouse  button  pressed  */ 
/*  Right  mouse  button  released  */ 
/*  all  mouse  events  */ 


♦define  NO  RANGE  255 


/*  mouse  pointer  not  in  range  xy  */ 


/* —  Macros - */ 

♦define  MouGetCol  ()  (ev_col)  /*  Return  mouse  position  &  */ 

♦define  MouGetRowO  (ev_row)  /*  range  the  moment  the  */ 

♦define  MouGetRange  ()  (ev_mg)  /*  event  occurs  */ 

♦define  MouAvailO  (  mavail  )  /*  Available  mouse  -  TRUE  */ 

♦define  MouGetCurCol  ()  (  moucol  )  /*  Returns  current  mouse  */ 

♦define  MouGetCurRowO  (  mourow  )  /*  position  and  current  */ 

♦define  MouGetCurRngO  (  mourng  )  /*  mouse  range  */ 

♦define  MouIsLeftPress  ()  (  mouevent  &  EV_LEFT_PRESS  ) 

♦define  MouIsLeftRel  ()  (  mouevent  &  EV_LEFT_REL  ) 

♦define  MouIsRightPress ()  (  mouevent  £  Ey_RIGHT_PRESS  ) 

♦define  MouIsRightRel ()  (  mouevent  &  EV_RIGHT_REL  ) 

♦define  MouSetMoveAreaAll  0  MouSetMoveArea  (  0,  0,  tcol-1,  tline-1  ); 


♦define  ELVEC(x)  (  sizeof(x)  /  sizeof(x[0])  )  /*  No.  of  elements  in  X  */ 


/* —  Bitmask  creation  macros  defining  mouse  pointer's  appearance.  - */ 

/* —  Syntax  for  calling  MouPtrMask  (sample) ;  - */ 

/*—  MouPtlMask(  PTRDIFCHAR(  'x*  ),  PTRINVCOL  )  - */ 

/* —  When  the  pointer  is  represented  as  a  lowercase  x,  the  Inverse - */ 

/* —  character  color  takes  effect.  - */ 


♦define  MouPtrMask (  z,  f  )\ 

(  ((  (PTRVIEW)  f)  »  8  «  24)  +  (((  PTRVIEW)  z)  »  8  «  16)  +\ 
(((f)  &  255)  «  8)  +  ((z)  &  255)  ) 


♦define 

♦define 

♦define 

♦define 

♦define 

♦define 

♦define 

♦define 

♦define 

♦define 

♦define 

♦define 


PTRSAMECHAR 

(  OxOOff  ) 

/*  Same  cahracter 

*/ 

PTRDIFCHAR (z) 

(  (z)  «  8  ) 

/*  Other  characters 

*/ 

PTRSAMECOL 

(  OxOOff  ) 

/*  Same  color 

*/ 

PTRINVCOL 

(  0x7777  ) 

/*  Inverse  color 

*/ 

PTRSAMECOLB 

(  0x807f  ) 

/*  Same  color  (blinking) 

*/ 

PTRINVCOLB 

(  0XF777  ) 

/*  Inverse  color  (blinking) 

*/ 

PTRDIFCOL(f) 

(  (f)  «  8  ) 

/*  Other  color 

*/ 

PTRDIFCOLB (f ) 

( ( (f )  1 0x80)  «  8) 

/*  Other  color  (blinking) 

*/ 

EAND  0 

/*  Event 

conparisons  for  MouEventWait () 

*/ 

EVOR  1 

MOUINT(rln,  rout)  int86(0x33,  4rin,  firout) 

MOUINTX(rin, 

rout,  sr)  int86x(0x33,  &rin,  &rout,  &sr) 

/* —  Macros  for  converting  mouse  coordinates  between  virtual  mouse  */ 
/* —  screen  and  text  screen  - */ 


♦define  XTOCOL(x) 
♦define  YTOROW(y) 
♦define  COLTOX(c) 
♦define  ROWTOY(r) 


(  (X)  »  3  ) 

(  (y)  »  3  ) 

(  (c)  «  3  ) 

(  (r)  «  3  ) 


/*  X  V  8  */ 
/*  Row  V  8  */ 
/*  C  X  8  */ 
/*  Row  X  8  */ 


global  variables 


BYTE  tline, 
tcol, 

mavail  -  FALSE; 


/*  No.  of  text  lines  */ 
/*  No.  of  text  columns  */ 
/*  TRUE  when  mouse  is  available  */ 


/* —  Mask  for  standard  mouse  pointer - 

PTRVIEW  St  dpt  r  »  MouPtrMask  (  PTRSAMECHAR,  PTRINVCOL  )  ; 
BYTE 


*  bbuf, 
num_range 


0; 


/*  Ptr  to  range  recognition  buffer  */ 
/*  No  range  defined  until  now  */ 
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RANGE  *  cur_range;  /*  Pointer  to  current  range  vector  */ 

Int  blen;  /*  Length  of  BBUF  in  bytes  */ 

/* —  Variables  which  load  every  time  the  mouse  handler  Is  called  - */ 

BYTE  mourng  -  NO_RANGE,  /*  Current  mouse  range  */ 

moucol,  /*  Mouse  column  (text  screen)  */ 

mourow;  /*  Mouse  row  (text  screen)  */ 

Int  mouevent  -  EV_IiEFT_REL  +  EV_RIGHT_REL;  /*  Event  mask  */ 

/★ —  Variables  which  load  every  time  an  event  anticipated  by  the  - */ 

/* —  mouse  handler  occurs  - */ 


BYTE  ev_rng,  /*  Range  In  which  the  mouse  can  be  found  */ 

ev_col,  /*  Mouse  column  */ 

ev_row;  /*  Mouse  row  */ 


/**★** *********************************************************** ******* 


*  Function  iMouDeflnePtr  * 

** _ ** 

*  Task  :  Defines  the  cursor  mask  and  screen  mask  which  * 

*  determines  the  mouse  pointer's  appearance  * 


*  Input  parameters  :  MASK  «  Both  bitmasks,  made  Into  a  32-blt  value  * 

*  of  type  UNSIGNED  LONG  * 

*  Return  value  :  None  * 

*  Info  :  Most  significant  16  bits  of  MASK  -  screen  mask  * 

*  least  significant  16  bits  of  mask  -  cursor  mask  * 
***********************************************************************/ 


♦pragma  check_stack (off) 


/*  No  stack  checking  here 


void  MouDef InePtr (  PTRVIEW  mask  ) 

{ 

static  PTRVIEW  oldercursor  =  (PTRVIEW)  0;  /*  Last  value  for  MASK 

union  REGS  regs;  /*  Processor  regs  for  Interrupt  call 


If  (  oldercursor  !*  mask  ) 
{ 

regs. X. ax  -  OxOOOa; 
regs.x.bx  »  0; 
regs.x.cx  »  mask; 
regs.x.dx  -  mask  »  16; 
MOUINT (regs,  regs) ; 
oldercursor  =*  mask; 

} 

} 


/*  Changes  since  last  call? 

/*  YES 

/*  Funct.  no.  for  "Set  text  pointer  type" 
/*  Create  software  pointer 
/*  Low  word  Is  AND-mask 
/*  High  word  Is  XOR-mask 
/*  Call  mouse  driver 
/*  Note  old  bitmask 


*/ 


*/ 

*/ 

*/ 

*/ 

*/ 

*/ 


/*********************************************************************** 


*  Function  iMouEventHandler  * 

** _ ** 

*  Task  :  Calls  AssmHand  routine  from  mouse  driver,  when  * 

*  a  mouse  related  event  occurs.  * 


*  Input  parameters  :  EvFlags  »  Event's  event  mask  * 

*  But State  =  Mouse  button  status  * 

*  X,  Y  =  Current  pointer  position,  converted  * 

*  Into  text  screen  coordinates  * 

*  Return  value  :  None  * 

*  Info  :  -  This  function  Ise  only  operational  through  a  * 

*  mouse  driver  call,  and  shouldn't  be  called  * 

*  from  another  function.  * 

*********************************************************************** / 


void  MouEvent Handler (  Int  EvFlags,  Int  ButState,  Int  x,  Int  y  ) 

{ 

♦define  LBITS  (  EV_LEFT_PRESS  |  EV_LEFT_REL  ) 

♦define  RBITS  (  EV_RIGHT_PRESS  |  EV_RIGHT_REL  ) 

unsigned  newrng;  /*  New  range  number  */ 
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mouevent  *^1; 

mouevent  |-  (  EvFlags  &  1  ); 

if  (  EvFlags  &  LBITS  )  /*  Left 

{ 

mouevent  6-  ~LBITS; 

mouevent  |-  (  EvFlags  &  LBITS  ); 

} 


/*  Clear  bit  0  */ 
/*  Copy  EvFlags  to  bit  0  */ 

mouse  button  pressed  or  released?  */ 
/*  YES  */ 

/*  Clear  previous  status  */ 
/*  Add  new  status  */ 


if  (  EvFlags  &  RBITS  )  /*  Right  mouse  button  pressed  or  released?  */ 


{ 

mouevent  -RBITS; 
mouevent  |»  (  EvFlags  &  RBITS  ); 

} 


/*  YES,  Clear  and  set  bits  */ 
/*  Clear  previous  status  */ 
/*  Add  new  status  */ 


moucol  »  x;  /*  Convert  columns  into  text  columns  */ 

mourow  »  y;  /*  Convert  rows  into  text  rows  */ 

/★ —  Check  range  in  which  mouse  is  currently  located,  and  coirpare  — */ 

/* —  to  range  since  last  call.  If  a  change  occurs,  the  pointer's  - */ 

/* —  appearance  will  have  to  be  changed.  - */ 


newrng  -  *  (kijuf  +  mourow  *  tcol  +  moucol);  /*  Get  range  */ 

if  (  newmg  !-  mourng  )  /*  New  range?  */ 

MouDefinePtr((newrng»-NO_RANGE)  ?  stdptr  : 

(cur_range+newrng)  ->ptr_mas)c) ; 

mourng  =  newrng;  /*  Place  range  number  in  global  variables  */ 

} 

fpragma  chec)c_stac)c  /*  Re-enable  stack  checking  and  old  */ 

#pragma  check_stack  /*  status  */ 


/***************** *****-K** ************************************** ******** 

*  Function  rMouIBufFill  * 

★★ _ ★★ 


*  Task  :  Stores  a  specific  screen  range  code  within  * 

*  screen  memory  affecting  the  module  * 

*  Input  parameters  :  xl,  yl  »  Upper  left  corner  of  the  screen  * 

*  x2,  y2  «  Lower  right  corner  of  the  screen  * 

*  CODE  *  Range  code  * 

*  Return  value  :  None  * 

*  Info  :  This  functions  should  only  be  called  from  within  * 

*  this  module.  * 

****************************i,i,*****************************************^ 


static  void  MouIBufFill (  BYTE  xl,  BYTE  yl, 

BYTE  x2,  BYTE  y2,  BYTE  code  ) 

{ 

register  BYTE  *  Iptr;  /*  Floating  pointer  to  range  mem.  */ 

BYTE  i,  j;  /*  Loop  counter  */ 

Iptr  =  k*>uf  +  yl  *  tcol  +  xl;  /*  Pointer  to  first  line  */ 

/* —  Go  through  individual  lines  - */ 

for  (j=x2  -  xl  +  1  ;  yl  <»  y2;  ++yl,  lptr+*tcol  ) 

memset(  Iptr,  code,  j  );  /*  Set  code  */ 

1 


/********************-k*******-tr-k*1i1r1fkit*********************************** 

*  Function  iMouDefRange  * 

** - ★★ 

*  Task  :  Allows  the  definition  of  different  screen  ranges  * 

*  which  configure  a  different  code  for  the  mouse  * 

*  pointer,  depending  on  the  pointer's  location.  * 

*  Input  parameters  :  -  NUMBER  =  Number  of  screen  ranges  * 

*  -  PTR  =  Pointer  to  screen  description  vector  * 

*  (type  RANGE)  * 

*  Return  value  :  None  * 

*  Info  :  -  Free  screen  ranges  receive  the  code  NO_RANGE.  * 

*  -  When  entering  the  specified  screen  range,  the  * 
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mouse  handler  automatically  changes  the  mouse  * 
pointer's  appearance  to  correspond  with  that  * 


»  range. 

*  -  Since  the  specified  pointer  Is  stored,  but  the 

*  specified  vector  Isn't  copied  to  a  separate 

*  buffer,  the  contencs  of  the  vecros  should  not 

*  be  changed  on  the  next  call  of  this  function. 
****************************************** 


void  MouDefRange(  BYTE  number,  RANGE  *  ptr  ) 

{ 

register  BYTE  1,  /*  Loop  counter  */ 

range;  /*  Mouse  range  */ 

cur_range  *  ptr;  /*  Reserve  pointer  to  vector  */ 

num_range  *  number;  /*  and  number  of  ranges  */ 

n^set  (  i>buf,  NO_RANGE,  blen  ) ; 
for  (1-0  ;  Knumber  ;  ++ptr  ) 

MouIBufFlll(  ptr->xl,  ptr->yl,  ptr->x2,  ptr->y2,  1++); 

/* —  Redefine  mouse  pointer - */ 


range  »  * (bbuf  +  mourow  *  tool  +  moucol) ;  /*  Current  mouse  range  */ 

MouDef InePtr (  (  range  —  NO_RANGE  )  ?  stdptr 
;  (cur_range+range)->ptrjnaslc  ); 


} 


*  Function 


MouEventWalt 


.** 


*  Task  :  Walts  for  a  specific  event  from  the  keyboard.  * 

*  Input  parameters  :  TYP  »  Establishes  comparison  between  * 

*  different  events.  * 

*  WAIT_EVENT  -  Bitmask  which  specifies  wait  event.  * 

*  Return  value  ;  Bitmask  which  describes  this  or  another  event.  * 

*  Info  :  -  WAIT__EVENT  can  be  used  with  other  constants  * 

*  such  as  EV_MCXJ_MOVE  or  EV_IiEFTJPRESS  when  used  * 

*  In  conjunction  with  EVOR.  * 

*  -  EAND  &  EVOR  are  allowable  types.  EAND  has  the  * 

*  ability  to  return  to  the  caller  once  ALL  events* 

*  have  occurred;  EVOR  returns  to  the  caller  when  * 

*  at  least  one  event  occurs.  * 

***********************************************************************/ 


Int  MouEventWalt (  BYTE  typ,  Int  waltjevent  ) 

{ 

Int  cur_event;  /*  Current  event  mask  */ 

register  BYTE  column  »  moucol,  /*  Last  mouse  position  */ 

line  »  mourow; 

BYTE  ende  *  FALSE;  /*  TRUE  If  an  event  occurs  */ 

while  (  !ende  )  /*  Repeat  until  event  occurs  */ 

{ 

/* —  Walt  until  one  of  the  events  occurs - */ 

If  (  typ  =»  EAND  )  /*  EAND:  All  events  must  occur  */ 

while  (  (cur_event  -  mouevent)  !-  walt_event) 

else  /*  EVOR:  At  least  one  event  must  occur  */ 

while  (  (  (cur__event  *  mouevent)  &  waltjevent)  ”  0) 


cur_event  waltjevent;  /*  Check  event  bits  only  */ 

/* —  When  moving  the  mouse,  the  event  Is  only  accepted  If  the  — */ 
/★ —  pointer  moves  to  another  row  or  column  on  the  text  screen  — */ 

If  ( (walt_event  &  EV_M0U_M0VE)  &&  column— moucol  &&  line— mourow) 

{  /*  Mouse  moves,  but  In  same  screen  position  */ 

curjevent  ("'EV_M0U_M0VE) ;  /*  Examine  move  bit  */ 
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ende  »  (cur_event  !-  0); 

) 

else 

ende  *  TRUE; 

} 

ev_col  -  moucol; 
ev_row  -  mourow; 
ev_rng  »  moumg; 
return (  cur_event  ) ; 

) 


/*  Are  events  pending?  */ 
/*  Event  occurred  */ 


/*  Set  current  mouse  position  */ 
/*  and  mouse  range;  place  in  */ 
/*  global  variables  */ 

/*  Return  event  mask  */ 


/********★***********************  4r  *******  ****1^***  ***********<:***  ******** 


*  Function  :MouISetEventHandler  * 

** _ ** 

*  Task  :  Installs  an  event  handler  which  handles  events  * 

*  called  fran  the  mouse  driver.  * 


*  Input  parameters  :  EVENT  «  Bitmask  which  specifies  the  event  which  * 

*  calls  the  event  handler.  * 

*  PTR  »  Pointer  to  the  mouse  handler  * 

*  Return  value  :  None  * 

*  Info  :  -  EVENT  can  be  used  in  conjunction  with  the  EVOR  * 

*  coitparison  on  constants  such  as  EV_MOU_MOVE,  * 

*  EV_LEFT_PRESS  * 

***********************************************************************/ 


static  void  MouISetEventHandler (  unsigned  event,  MCXJHAPTR  ptr  ) 

1 

union  REGS  regs;  /*  Processor  regs  for  interrupt  call  */ 

struct  SREGS  sregs;  /*  Segment  register  for  interrupt  call  */ 


regs. X. ax  =  OxOOOC;  /* 

regs.x.cx  *  event; 
regs.x.dx  =  FP_OFF(  ptr  ); 
sregs.es  =  FP_SEG(  ptr  ); 
MOUINTX (  regs,  regs,  sregs  ) ; 

} 


Funct.  no.  for  **Set  Mouse  Handler**  */ 
/*  Load  event  mask  */ 
/*  Offset  address  of  handler  */ 
/*  Segment  address  of  handler  */ 
/*  Call  mouse  driver  */ 


/*********************************************************************** 


*  Function  :MouIGetX  * 

*  Task  :  Determines  text  column  in  which  pointer  lies.  * 

*  Input  parameters  ;  None  * 

*  Return  value  :  Mouse  pointer  column,  relative  to  text  screen  * 


***********************************************************************/ 


static  BYTE  MouIGetX(  void  ) 

{ 

union  REGS  regs;  /*  Processor  regs  for  interrupt  call  */ 


regs.x.ax»  0x0003; 

MOUINT (  regs,  regs  ) ; 
return  XTOCOL(  regs.x.cx  ); 

1 


/*  Funct.  no.  for  "Get  mouse  position"  */ 
/*  Call  mouse  driver  */ 
/*  Convert  and  return  column  */ 


/*********************************************************************** 


*  Function  :MouIGetY  * 

** _ ** 

*  Task  :  Determines  text  row  in  which  pointer  lies.  * 

*  Input  parameters  :  None  * 

*  Return  value  :  Mouse  pointer  row,  relative  to  the  text  screen  * 


***********************************************************************/ 


static  BYTE  MouIGetY(  void  ) 

{ 

union  REGS  regs;  /*  Processor  regs  for  interrupt  call  */ 

regs.x.ax®  0x0003;  /*  Funct.  no.  for  "Get  mouse  position"  */ 

MOUINT (regs,  regs);  /*  Call  mouse  driver  */ 

return  YTOROW (regs.x.dx) ;  /*  Convert  and  return  row  */ 

} 
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/itititikitititititikitititititikititititititititit  ********  ************************************** 


*  Function  rMouShowMouse  * 

** _ ★★ 

*  Task  :  Display  mouse  pointer  on  the  screen.  * 

*  Input  parameters  :  None  * 

*  Return  value  :  None  * 

*  Info  :  Calls  of  MouHldeirMouse  ()  and  MouShowMouse  ()  must  * 

*  be  kept  balanced.  * 


***********************************************************************/ 


void  MouShowMouse (  void  ) 

{ 

union  REGS  regs;  /*  Processor  regs  for  Interrupt  call  */ 

regs.x.ax  -  0x0001;  /*  Funct.  no.  for  "Show  Mouse"  */ 

MOUINT(regs,  regs);  /*  Call  mouse  driver  */ 

} 


/*********************************************************************** 


*  Function  :MouHldeMouse  * 

** _ ** 

*  Task  :  Hide  mouse  pointer  from  screen.  * 

*  Input  parameters  :  None  * 

*  Return  value  :  None  * 

*  Info  :  Calls  of  MouHldemMouse  ()  and  MouShovMouse  ( )  must  * 

*  be  kept  balanced.  * 


***********************************************************************/ 


void  MouHldeMouse (  void  ) 

{ 

union  REGS  regs;  /*  Processor  regs  for  Interrupt  call  */ 


regs.x.ax  »  0x0002; 
MOUINT (regs ,  regs ) ; 

} 


/*  Funct.  no.  for  "Hide  Mouse"  */ 
/*  Call  mouse  driver  */ 


/*********************************************************************** 


*  Function  iMouSetMoveArea  * 

*  Task  ;  Defines  a  screen  range  within  which  the  mouse  * 

*  pointer  may  be  moved.  * 


*  Input  parameters  :  xl,  yl  »  Coordinates  of  upper  left  corner  * 

*  x2,  y2  =  Coordinates  of  lower  right  corner  * 

*  Return  value  :  None  * 

*  Info  ;  -  Both  parameters  apply  to  text  screen,  NOT  the  * 

*  mouse  driver's  virtual  graphic  screen  -  * 

***********************************************************************  ^ 


void  Mouse tMoveArea (  BYTE  xl,  BYTE  yl,  BYTE  x2,  BYTE  y2  ) 

{ 

union  REGS  regs;  /*  Processor  regs  for  Interrupt  call  */ 


regs.x.ax  *  0x0008; 

regs.x.cx  =  ROWTOY(  yl  ); 

regs.x.dx  =  ROWTOY(  y2  ); 

MOUINT (regs,  regs) ; 
regs.x.ax  =  0x0007; 

regs.x.cx  =  COLTOX(  xl  ); 

regs.x.dx  =  COLTOX(  x2  ); 

MOUINT (regs,  regs); 

} 


/*  Funct.  no.  for  "Set  vertical  Limits"  */ 
/*  Conversion  to  virtual  */ 
/*  mouse  screen  */ 

/*  Call  mouse  driver  */ 
/*  Funct.  no.  for  "Set  horizontal  Limits"  */ 
/*  Conversion  to  virtual  */ 
/*  mouse  screen  */ 

/*  Call  mouse  driver  */ 


/************************* *****i,***************** ***************  ******** 

*  Function  iMouSetSpeed  * 

*  Task  :  Determines  the  difference  between  mouse  movement  * 

*  speed  and  the  resulting  pointer  speed  on  the  * 

*  screen.  * 

*  Input  parameters  :  -  XSPEED  =  Horizontal  speed  ♦ 
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*  -  YSPEED  -  Vertical  speed  * 

*  Return  value  :  None  * 

*  Info  :  -  Both  parameters  are  based  on  mickeys  * 

*  (mickey  /  8  pixel) .  ♦ 

*★**★*************************************★*******************★********/ 

void  MouSetSpeed(  int  xspeed,  int  yspeed  ) 

{ 

union  REGS  regs;  /*  Processor  regs  for  interrupt  call  */ 

regs.x.ax  *  OxOOOf;  /*  Funct.  no.  for  "Set  mickeys  to  pixel  ratio"  */ 

regs.x.cx  -  xspeed; 
regs.x.dx  *  yspeed; 

MOUINT(regs,  regs);  /*  Call  mouse  driver  */ 

} 


/★★★★★ ★★*★***★*★♦★★**★*★★**********★****★*★***★**★**★**★*★★★★* *★★★★★*★** 


*  Function  rMouMovePtrs-  * 

★  * _ _ _ - _ - _ ★★ 

*  Task  /  :  Moves  the  mouse  pointer  to  a  specific  position  * 

*  on  the  screen.  * 


*  Input  parameters  :  -  COL  »  new  screen  column  * 

*  -  RCW  «  new  screen  row  * 

*  Return  value  :  None  * 

*  Info  :  -  Both  parameters  apply  to  the  text  screen,  NOT  * 

*  to  the  mouse  driver's  virtual  graphic  screen  * 

**********  ***1tifk  **1t**1t**-k**  **************************  It  *********  it*  ******/ 


void  MouMovePtr(  int 
{ 

union  REGS  regs; 
unsigned  newrng; 


col,  int  row  ) 

/*  Processor  regs  for  interrupt  call  */ 
/*  Range  in  which  the  mouse  can  move  */ 


regs.x.ax  *  0x0004;  /*  Funct.  no. 
regs.x.cx  *  COLTOX(  moucol  *  col  ); 
regs.x.dx  »  ROWTOY (  mourow  *  row  ); 
MOUINT (regs,  regs) ; 


for  "Set  mouse  pointer  poslt^ion"  */ 
/*  Convert  coordinates  and  store  */ 
/*  in  global  variables  */ 

/*  Call  mouse  driver  */ 


newmg  =  *  (bbuf  +  mourow  *  tcol  +  moucol) ;  /*  Get  range  */ 

if  (  newrng  !»  mourng  )  /*  New  range?  */ 

MouDefinePtr((newrng«NO_RANGE)  ?  stdptr  : 

(cur_range+newrng)->ptr_mask) ; 

mourng  =  newrng;  /*  Place  range  number  in  global  variables  */ 

} 


/*********************************************************************** 
*  Function  :MouSetDefaultPtr  * 


*  Task  :  Defines  mouse  pointer  for  screen  ranges  without  * 

*  the  help  of  MouDef Range.  * 

*  Input  parameters  :  STANDARD  =  Bitmask  for  standard  mouse  pointer  * 

*  Return  value  :  None  * 

***********************************************************************/ 


void  MouSetDefaultPtr (  PTRVIEW  standard  ) 

{ 

stdptr  =  standard;  /*  Place  bitmask  in  global  variables  */ 

/* —  If  mouse  is  currently  in  no  range,  go  direct  to  conversion  - */ 

/* —  to  new  pointer  appearance  - */ 

if  (  MouGet Range  0  ==  NO_RANGE  )  /*  Not  in  any  range?  */ 

MouDefinePtr (  standard  );  ^  /*  NO  */ 

} 

/*****************************it  ***********************************  ****** 


*  Function  :  M  o  u  E  n  d  * 

*★ - ** 

*  Task  :  Ends  mouseC  module  functions.  * 


*  Input  paranffiters  :  None 


648 


Abacus 


14.  Mouse  Programming 


*  Return  value  :  None  * 

*  Info  :  Function  is  called  automatically  when  program  * 

*  ends,  as  long  as  Moulnstall  is  called  first.  * 


void  MouEnd(  void  ) 

{ 

union  REGS  regs; 

MouHideMouse () ; 
regs. X. ax  »  0; 

MOUINT (regs ,  regs ) ; 

free (  bbuf  ) ; 

} 

*  Function  :MouInit  * 


*  Task  :  Initializes  variables  and  mousec  module  * 

*  Input  parameters  ;  Columns,  *  Text  screen  resolution  * 

*  Lines  * 

*  Return  value  :  TRUE  if  a  mouse  is  installed,  else  FALSE  * 

*  Info  :  This  function  must  be  called  as  the  first  one  in  * 

*  the  module.  * 

******* ★*★***★*****★***★★**★******★****★*****★** ★*★★*******************/ 


/*  Processor  regs  for  interrupt  call  */ 

/*  Hide  mouse  pointer  from  screen  */ 
/*  Reset  mouse  driver  */ 
/*  Call  mouse  driver  */ 

/*  Release  allocated  memory  */ 


BYTE  Moulnit (  BYTE  columns,  BYTE  lines  ) 

{ 

union  REGS  regs;  /*  Processor  regs  for  interrupt  call  */ 


tllne  »  lines; 
tcol  ”  columns; 


/*  Store  no.  of  lines  and  cols  */ 
/*  in  global  variables  */ 


atexit (  MouEnd  ) ; 


/*  Call  MouEnd  at  end  of  program  */ 


/* —  Allocate  and  fill  mouse  range  buffer - */ 


bbuf  =  (BYTE  *)  malloc(  blen  -  tllne  *  tcol  ); 
MouIBufFill(  0,  0,  tcol-1,  tllne-1,  NO_RANGE  ); 


regs. X. ax  *  0; 

/*  Initialize  mouse  driver 

*/ 

MOUINT (regs,  regs); 

/*  Call  mouse  driver 

*/ 

if  (  regs. X. ax  !»  Oxffff  ) 

/*  Mouse  driver  installed? 

*/ 

return  FALSE; 

/*  NO 

*/ 

MouSetMoveAreaAll (); 

/*  Set  range  of  movement 

*/ 

moucol  =  MouIGetXO; 

/*  Load  current  mouse  pos. 

mourow  =  MouIGetYO; 

/*  into  global  variables 

*/ 

/* —  Install  assembler  event  handler 

"AssmHand"  - 

.*/ 

MouISetEventHandler (  EV_MOU_ALL,  (MOUHAPTR)  AssmHand  ) ; 


return  mavall  =  TRUE;  /*  Mouse  is  Installed  */ 

) 


/*************************************«********************************* 
*  MAIN  PROGRAM  * 

***********************************************************************/ 


Int  main(  void  ) 

( 

static  RANGE  ranges []  » 
{ 


0, 

0, 

79, 

0, 

MouPtrMask ( 

0, 

0, 

23, 

MouPtrMask ( 

0, 

24, 

78, 

24, 

MouPtrMask ( 

79, 

1, 

79, 

23, 

MouPtrMask ( 

79, 

24,  79, 

24, 

MouPtrMask ( 

PTRDIFCHAR(0xl8) , 
PTRDIFCHAR(Oxlb), 
PTRDIFCHAR(0xl9), 
PTRDIFCHAR(Oxla) , 
PTRDIFCHAR('X') , 


/*  Mouse  ranges  */ 

PTRINVCOL)  }, 
PTRINVCOL)  } , 

PTRINVCOL)  }, 
PTRINVCOL)  } , 
PTRDIFCOLB(0x40)  )  }, 
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}; 


printf  ("XnMOUSEC  -  (c)  1989  by  MICHAEL  TISCHERXnXn**) ; 

if  (  Mbulnit  (  80,  25  )  )  /*  Initialize  mouse  module  */ 

{  /*  OK,  there  is  an  installed  mouse  driver  */ 

print f ("Move  the  mouse  pointer  around  on  the  screen.  When  you  move\n"\ 
"the  mouse  ix>inter  to  the  border  of  the  screen,  the\n"\ 
"mouse  pointer  changes  in  appearance,  depending  upon  its\n"\ 
"Current  position. \n\n" 

"Move  the  mouse  pointer  to  the  lower  right  comer  of  the\n"\ 
"screen,  and  press  both  the  left  and  right  mouse  buttons\n"\ 
"to  end  this  demo  program. \n"  ); 

MouSetDefaultPtr (  MouPtrMas)c(  PTRDIFCHAR(  •[•  ),  PTRDIFCOL(  3  )  )  ); 
MouDefRange(  ELVEC(  ranges  ),  ranges  );  /*  Range  definition  */ 

MouShowMouse () ;  /*  Display  mouse  pointer  on  the  screen  */ 

/* —  Wait  until  the  user  presses  the  left  and  right  mouse  — */ 

/* —  buttons  simultaneously,  AND  the  mouse  pointer  lies  int  — */ 

/* —  range  4  — */ 

do  /*  Read  loop  */ 

MouEventWait (  EAND,  EV_LEFT_PRESS  |  EV_RIGHT_PRESS  ); 
while  (  Mo uGet Range  0  4  ); 

return  0;  /*  Return  OK  code  to  DOS  */ 

} 

else  /*  No  mouse  OR  mouse  driver  installed  */ 

( 

pr int f ("Sorry,  no  mouse  driver  installed. \n") ; 

return  1;  /*  Return  error  code  to  DOS  */ 

} 


Assembler  listing:  MOUSECA.ASM 


.*****************************★********************★********•***********• 
;*  M  0  U  S  E  C  A  *; 


Task 

:  Mouse  driver  event  handler  intended  for 
linking  to  a  C  program  ccxnpiled  as  a  SMALL 
memory  model. 

*  • 

t 

*  • 

*• 

Author 

:  MICHAEL  TISCHER 

★  • 

Developed  on 

:  04/20/1989 

*  • 

Last  update 

:  06/14/1989 

★  • 

assembly 

:  MASM  /MX  MOUSECA/ 

■k  . 

. . .  link  to  program  MOUSEC 

*  - 

• *************************************★********************************; 


;==  Segment  declarations  for  the  C  program  == 


IGROUP  group  _text  ; Inclusion  for  program  serpent 

DGROUP  group  const, _bss,  _data  ; Inclusion  for  data  segment 
assume  CS: IGROUP,  DS: DGROUP,  ES: DGROUP,  SS; DGROUP 


CONST  segment  word  public  'CONST* ;This  segment  includes  all  read-only 
CONST  ends  /constants 


BSS  segment  word  public  'BSS* 
BSS  ends 


/This  segment  includes  all  un- 
/ initialized  static  variables 


DATA 

DATA 


segment  word  public  'DATA* 
ends 


/This  segment  includes  all  initialized 
/global  and  static  variables 


/*=  Program 


650 


Abacus 


14,  Mouse  Programming 


TEXT  segment  byte  public  'CODE'  /Program  segment 


public  _AssmHand  /Gives  the  C  program  the  ability  to 

/access  assembler  handler  addresses 

extm  _MouEventHandler  :  near  /Event  handler  to  be  called 

active  db  0  /Indicates  whether  a  call  is  under 

/execution 


r —  _AssmHand  :  The  event  handler  called  ty  the  mouse  driver,  then 
^ —  called  by  the  MouEventHandler ()  function 

r —  Call  from  C;  not  allowed! 

AssmHand  proc  far 

/ —  Place  all  processor  registers  on  the  stack  - 

cmp  active, 0  /Call  still  not  finished? 

jne  ende  /NO  — >  Do  not  exit  call 

mov  active,!  /No  more  calls 

push  ax 
push  bx 
push  cx 
push  dx 
push  di 
push  si 
push  bp 
push  es 
push  ds 


—  Place  all  arguments  for  calling  C_FCT  on  the  stack  - 

—  Call:  MouEventHandler (  int  EvFlags,  int  ButStatus, 

int  X,  int  y  )/ 


mov 

di,cx 

/Place  horizontal  coordinate  in  DI 

mov 

cl,  3 

/Counter  for  coordinate  number 

shr 

dx,  cl 

/Divide  DX  (vertical  coord.)  by  8 

push 

dx 

/and  place  on  the  stack 

shr 

di,cl 

/Divide  DI  (horizontal  coord.)  by  8 

push 

di 

/and  place  on  the  stack 

push 

bx 

/Push  mouse  button  status  onto  stack 

push 

ax 

/Push  event  flag  onto  stack 

mov 

ax,  DGROUP 

/Move  segment  address  of  DGROUP  to  AX 

mov 

ds,ax 

/Move  AX  to  DS  register 

call 

_MouEventHandler 

/C  function  call 

add 

sp,8 

/Get  arguments  from  stack 

/ —  Pop  register  contents  off  of  stack  - 


pop 

ds 

pop 

es 

pop 

bp 

pop 

si 

pop 

di 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

mov  active, 0 


/Re-enable  call 
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ende: 

AssinHand 


text 


ret  ; Return  to  mouse  driver 

endp 


ends  ;End  of  code  segment 

end  ;End  of  program 
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Determining  Processor 
Types 


There  are  number  of  utility  programs  on  the  market  today  which  can  tell  you  about 
the  configuration  of  a  PC.  This  information  can  include  the  amount  of  available 
RAM,  the  running  DOS  version  and  the  type  of  processor  the  PC  has. 

This  information  can  be  very  useful  for  developing  programs  in  high  level 
languages,  since  code  generation  can  be  adapted  to  the  particular  processor.  For 
example,  both  Microsoft  C  and  Turbo  C  allow  special  code  generation  for  the 
8088,  the  80286  and  the  80386,  which  makes  full  use  of  the  capabilities  of  the 
particular  processor  and  instruction  set  This  can  dramatically  improve  performance 
for  programs  which  work  with  large  groups  of  data.  One  way  to  take  advantage  of 
this  would  be  to  compile  the  program  once  for  each  of  the  three  processor  types. 
Then  a  program  could  be  developed  to  serve  as  the  boot  for  the  actual  program. 
This  boot  program  would  determine  the  type  of  processor  being  used  and  load  the 
main  program  version  most  compatible  with  the  processor. 

Which  processor  is  which?  j 

This  raises  the  question  of  how  to  determine  which  type  of  processor  is  being 
used,  since  unlike  other  configuration  information,  we  cannot  find  this  out  by 
making  a  BIOS  or  DOS  call.  Unfortunately,  there  is  no  machine  language 
instruction  which  instructs  the  processor  to  reveal  its  identity,  so  we  have  to  use  a 
trick.  This  trick  relies  on  a  condition  which,  according  to  a  few  hardware 
manufacturers,  is  totally  impossible. 

This  is  a  test  which  involves  the  different  ways  the  various  processors  execute 
certain  machine  language  instructions.  Although  processors  from  the  8086  to  the 
80386  are  upwardly  software  compatible,  the  development  of  this  processor  series 
brought  small  changes  in  the  logic  of  certain  instructions.  Since  these  changes  are 
only  noticeable  in  rare  situations,  a  program  developed  for  the  8088  processor  will 
also  run  correctly  on  all  other  processors  in  the  Intel  80x86  series.  But  if  we 
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deliberately  put  a  processor  into  such  a  situation,  we  can  determine  its  identity 
from  its  behavior. 

These  differences  are  only  noticeable  at  the  assembly  language  level,  so  our  test 
program  must  be  written  in  assembly  language.  We  have  included  listings  at  the 
end  of  this  chapter  which  allow  the  test  routine  to  be  included  in  Pascal,  C  and 
BASIC  programs  as  well. 


Determining  processor  type  on  a  PC 
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As  the  flowchart  above  shows,  the  routine  consists  of  several  tests  which  can 
distinguish  various  process^  types  from  one  another.  The  next  test  executes  only 
whra  the  current  test  returns  a  negative  response. 

Flag  register  test 

The  first  test  concerns  the  different  layout  of  the  flag  register  in  the  different 
processes.  The  meaning  of  bits  0  to  1 1  is  the  same  in  all  processcHS,  but  bits  12- 
IS  are  also  defined  in  processors  from  80286  up  (through  the  introduction  of  the 
protected  mode).  This  can  be  noticed  in  the  instructions  PUSHF  (push  the  contents 
of  the  flag  registo*  onto  the  stack)  and  POPF  (fetch  the  contents  of  the  flag  register 
from  the  stack).  On  processors  through  the  80188  these  instructions  always  set 
bits  12-15  of  the  flag  regista  to  1,  but  this  doesn't  occur  in  the  80286  and  80386 
processors.  The  first  test  in  the  routine  takes  advantage  of  this  fact,  in  which  it 
places  the  value  0  on  the  stack  and  then  loads  it  into  the  flag  register  with  the 
POPF  instruction.  Since  there  is  no  instruction  for  comparing  die  contents  of  bits 
12  to  IS,  the  flag  register  is  pushed  back  onto  the  stack  with  a  PUSHF 
instruction.  This  is  so  we  can  get  the  contents  into  the  AX  register  with  POP  AX, 
where  we  can  test  bits  12  to  IS. 

If  all  four  bits  are  set,  then  the  processor  cannot  be  an  80286  or  an  80386,  and  the 
next  test  is  performed.  Howevw,  if  not  all  four  bits  are  set,  then  we  have  reduced 
the  set  of  possible  processors  to  the  80826  and  the  80386.  Since  POPF  also 
operates  differoidy  tetween  these  two  processes,  it  is  easy  to  tell  them  tyiait  We 
simply  repeat  the  whole  process,  this  time  by  placing  the  value  07000H  on  the 
stack  instead  of  0.  When  ^e  flag  register  is  lo^ed  with  the  POPF  instruction,  bits 
12  to  14  of  the  flag  register  will  be  set  to  1.  If  these  bits  are  no  longer  1  when  the 
contents  of  the  flag  registo*  are  fetched  from  the  stack,  then  the  processor  must  be 
an  80286,  which,  in  contrast  to  the  80386,  sets  these  three  bits  back  to  0.  The  test 
is  then  concluded  for  these  two  processors. 

Narrowing  down  the  field 

If  the  processor  did  not  pass  the  first  test,  the  following  test  will  show  if  it  is  an 
80188  or  80186.  With  the  introduction  of  these  two  processors,  the  shift 
instructions  Gike  SHL  and  SHR)  woe  changed  in  the  way  they  use  the  CL  register 
as  a  shift  counter.  While  in  previous  processors  the  number  of  shifts  could  be 
between  0  and  2SS,  the  upper  three  bits  of  the  CL  register  are  now  cleared  before 
the  instructions  starts,  limiting  the  numba  of  shift  opoations.  This  makes  sense 
since  a  word  will  contain  all  zeros  anyway  after  at  most  16  shifts  (17,  if  the  carry 
flag  is  shifted).  Additional  shifts  will  cost  valuable  processor  time  and  will  not 
change  the  value  of  the  argument  at  all. 

The  second  test  makes  use  of  this  behavior  by  shifting  the  value  OFFH  in  the  AL 
register  21 H  positions  to  the  right  with  the  SHR  instruction.  If  the  processor 
executing  the  instruction  is  an  80188  or  later  type,  the  upper  three  bits  of  the  shift 
counter  will  first  be  cleared,  and  only  one  shift  is  perform^  instead  of  21H  shifts. 
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021H  (00100001 <b) )  number  of  shifts 
&  OlfH  (00011111(b))  mask  out  the  upper  three  bits 

OOIH  (00000001(b))  actual  number  of  shifts 

Unlike  its  predecessors,  which  would  actually  shift  the  value  OFFH  to  the  right 
021H  times  and  return  the  value  0,  the  80188  and  80186  will  return  the  value 
07FH.  By  checking  the  contents  of  the  AL  register  after  the  shift  we  can  easy  tell 
if  the  processTM'  is  an  80188  or  80186  (AL  not  zero),  ot  not  (AL  equal  to  0).  If  the 
processor  also  fails  this  test,  then  we  Imow  it  is  an  8088/80^  ot  V20/30. 

y20  and  V30  processors 

The  V20  and  V30  processors  are  8088/8086  "clones"  which  use  the  same 
inslniction  set  as  their  Intel  cousins,  but  which  opemt&  considoably  faster  due  to 
the  optimization  of  intOTnal  logic  and  improved  manufacturing.  This  speed  also 
results  in  a  higher  cost,  so  some  PC  manufacturers  avoid  using  these  processors. 

In  addition  to  die  faster  execution  of  instructions,  these  processors  also  corrected  a 
small  OTTor  which  occurs  in  the  8088  and  8086  processOTS.  If  a  hardware  intOTrupt 
is  generated  during  the  execution  of  a  string  instruction  (such  as  LODS)  in 
connection  with  the  REP(eat)  prefix  and  a  segment  ovOTride,  the  execution  of  this 
instruction  will  not  resume  after  the  interrupt  has  bera  processed.  This  can  easily 
be  detOTmined  because  the  CX  registOT,  which  functions  as  the  lo<^  counter  in  this 
instruction,  will  not  contain  a  0  as  expected  after  the  instruction. 

We  make  use  of  this  behaviOT  in  the  test  inogram  by  loading  the  CX  register  with 
the  value  OFFFFH,  and  then  executing  a  string  instruction  6SS35  times  with  the 
REP  prefix  and  segment  override.  Since  even  a  fast  processor  needs  some  time  to 
do  this,  a  hardware  interrupt  will  be  generated  during  one  of  the  6SS35  executions 
of  this  instruction.  In  the  case  of  the  8088  or  8086,  the  instruction  will  not  be 
resumed  after  the  interrupt,  and  the  remaining  "loop  passes"  will  not  execute.  The 
test  program  verifies  this  from  the  CX  register  after  the  instruction  has  been 
executed. 

Data  bus  test 

Once  we  have  distinguished  between  the  8088/8086  and  the  V20/30,  one  last  test 
is  performed  for  all  processors  (except  the  80286  and  80386).  In  this  test  we 
determine  if  the  processor  is  using  an  8-bit  or  a  16-bit  data  bus.  This  allows  us  to 
tell  the  difference  between  the  8088  and  8086,  the  V20  and  V30,  or  the  80188  and 
the  80186.  We  cannot  determine  the  width  of  the  data  bus  with  assembly  language 
commands,  but  the  data  bus  width  is  related  to  the  length  of  the  instruction  queue 
within  the  processor. 


Queue 

The  queue  stores  the  instructions  following  the  instruction  currently  being 
executed.  Since  these  instructions  are  taken  from  the  queue  and  not  fiom  memmy, 
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this  improves  execution  speed.  This  queue  is  six  bytes  long  on  processors  with  a 
16-bit  data  bus,  but  only  four  bytes  long  on  processors  with  an  8-bit  data  bus. 

The  last  test  is  based  on  this  difference  in  length.  The  string  instruction  STOSB 
(store  string  byte)  used  in  connection  with  the  REP  preEx  modifies  three  bytes  in 
die  code  segment  immediately  following  the  STOSB  instruction.  These  bytes  are 
placed  so  that  they  are  found  within  the  queue  on  a  processor  with  a  six-byte 
queue;  the  processor  won't  even  notice  the  change.  On  a  processor  with  a  four-byte 
queue,  these  instructions  are  still  outside  the  queue,  so  the  modified  versions  of  the 
instructions  are  loaded  into  the  queue.  The  program  makes  use  of  this  by 
modifying  the  instruction  INC  DX,  which  increments  the  contents  of  the  DX 
register  which  contains  the  processor  code  in  the  routine.  This  instruction  is 
executed  only  when  die  processor  has  a  six-byte  queue,  and  the  instruction  was 
already  in  the  queue  by  the  time  the  modificadon  was  poformed. 

On  a  processor  with  a  four-byte  queue,  this  instruction  is  replaced  by  the  STI 
instruction,  which  doesn't  affect  the  cont»its  of  the  DX  register  (or  the  process^ 
code).  STI  sets  the  interrupt  bit  in  the  processor  flag  register.  Since  this  procedure 
always  increments  the  processor  code  by  one  for  16-bit  processors,  the  processor 
codes  in  the  routine  are  chosen  so  that  the  code  for  the  16-bit  version  of  a 
processes'  always  follows  the  code  for  the  8-bit  version  of  the  same  processor. 

The  following  BASIC  and  Pascal  programs  use  DATA  or  inline  statements  instead 
of  assembly  language.  Howeva*,  we  included  the  assembly  language  versions  of 
these  statements  here  so  that  you  can  follow  the  program  logic.  The  C 
implementation  requires  direct  linking  of  C  and  the  assembly  language  routine. 

BASIC  listing:  PROCB.BAS 

100  ' ****************★★**★***★★*★**★**★★*★★★★★★★★**★**★*★★*★★*★★★*★★**★ • 


110  '* 
120 

PROCB 

*  1 

130  '* 

Task 

:  Examines  the  main  processor  and  tells  the 

★  • 

140  '* 

user  the  processor  type 

*  • 

150  •* 

Author 

:  MICHAEL  TISCHER 

*  • 

160  '* 

Developed  on 

:  09/06/1988 

★  • 

170  '* 

Last  update 

:  05/23/1989 

*  • 

180  ' ********************* **★**★******★*★*★**★***★★★★*★*★*★★**** ★*★★**★ • 

190  • 

200  CLS  :  KEY  OFF 

210  PRINT^ATTENTIC*!:  This  program  should  only  be  run  when  GW-BASIC  is  loaded  fraa" 
220  PRINT-the  DOS  preanpt  using  the  command  <GWBASIC  /m:60000>." 

230  PRINT  :  PRINT''If  this  isn't  the  case,  press  the  <s>  key  to  stop." 

240  PRINT" Otherwise,  press  any  other  key  to  continue...  "; 

250  A$  =  INKEY$  :  IF  A$  =  "s"  THEN  END 
260  IF  A$  »  ""  THEN  250 

270  CLS  'Clear  screen 

280  GOSUB  60000  'Install  assembler  routine 

290  CALL  PT(PTYP%)  'Determine  processor  type 

300  RESTORE  1000  'Read  DATA  statements  starting  at  line  1000 

310  FOR  1%  -  0  TO  PTYP%  :  READ  P$  :  NEXT  'Get  processor  name 

320  PRINT  "PROCB  -  (c)  1988  by  MICHAEL  TISCHER" 

330  PRINT  "Your  PC  contains  a(n)  ";P$;"  processor." 

340  END 
350  ' 

1000  DATA  "INTEL  8088",  "INTEL  8086",  "NEC  V20",  "NEC  V30" 

1010  DATA  "INTEL  80186",  "INTEL  80188",  "INTEL  80286",  "INTEL  80386" 
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1020  • 

60000  ' **************************************************************** • 
60010  Routine  for  determining  onboard  processor  type  *' 

60030  •*  Input  :  none  *' 

60040  '*  Output  :  PT  is  the  starting  address  of  the  assanbler  routine 
60050  **  Call  to  the  routineiCALL  PT(PTYP%)  *' 

60060  ***************************************************************** • 
60070  • 

60080  PT-60000!  'Starting  address  of  BASIC  segment  routine 

60090  DEF  SEG  'Define  BASIC  segment 

60100  RESTORE  60140 

60110  FOR  1%  -  0  TO  105  :  READ  X%  :  POKE  PT+I%,X%  :  NEXT  'POKE  routine 
60120  RETURN  'Return  to  caller 

60130  ' 

60140  DATA  85,139,236,156,  6,  51,192,  80,157,156,  88,  37,  0,240,  61 

60150  DATA  0,240,116,  19,178,  6,184,  0,112,  80,157,156,  88,  37,  0 

60160  DATA  112,116,  54,254,194,235,  50,144,178,  4,176,255,177,  33,210 

60170  DATA  232,117,  18,178,  2,251,190,  0,  0,185,255,255,243,  38,172 

60180  DATA  11,201,116,  2,178,  0,  14,  7,253,176,251,185,  3,  0,232 

60190  DATA  23,  0,250,243,170,252,144,144,144,  66,144,251,  50,246,139 

60200  DATA  126,  6,137,  21,  7,157,  93,202,  2,  0,  95,131,199,  9,235 

60210  DATA  227 

Assembler  listing:  PROCBA.ASM 


t 

P  R  0  C  B  A 

★ . 

9 

•  ★ 

Task: 

:  Determines  the  type  of  processor  installed  in 

t 

■k  • 

•  ★ 

a  PC 

*  . 

This  BASIC  version  of  the  program  converts 

;* 

DATA  statements  into  machine  language,  and 

*; 

•  ★ 
t 

executes  this  code  in  the  BASIC  program 

*  • 

t 

t 

Author 

:  MICHAEL  TISCHER 

*; 

Developed  on 

:  09/05/1988 

■k. 

.* 

f 

•  *_ 

Last  update 

:  05/24/1989 

k, 

—  ★  • 

•  ★ 
r 

assembly 

:  MASM  PROCBA; 

★  • 
/ 

•  * 

/ 

LINK  PROCBA; 

★  • 

•  * 

EXE2BIN  PROCBA  PROCBA.BIN 

*; 

•  ★ 

convert  to  DATA  statements  and  add  to 

k  • 

t 

•  ★ 
t 

a  BASIC  program 

k  • 

Const 

p  80386 

ants  * 

equ 

7 

; Codes  for  different  processor 

p  80286 

equ 

6 

; types 

p  80186 

equ 

5 

p_80188 

equ 

4 

p_v30 

equ 

3 

p  v20 

equ 

2 

p  8086 

equ 

1 

p_8088 

Code 

equ 

0 

code 

segment  para  'CODE* 

'  /Definition  of  CC©E  segment 

org 

lOOh 

assume  csicode,  ds: 

:  code,  ss : code,  es : code 

getproc 

proc 

far 

;GW-BASIC  waits  for  CALL  FAR  procedure 

push 

bp 

/Push 

BP 

onto  stack 

mov 

bp,  sp 

/Move 

SP 

after  BP 
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pushf  ;Save  contents  of  flag  registers 

push  es  ;Marlc  ES 

test  for  80386/80286  - 


xor  ax,  ax 

;Set  AX  to  0  and 

push  ax 

;push  onto  stack 

popf 

;Get  as  flag  register  from  stack 

pushf 

;Put  on  stack  again  and 

pop  ax 

/return  to  AX 

and  ax, OfOOOh 

/Don't  clear  the  top  4  bits 

onp  ax, OfOOOh 

/Are  bits  12-15  all  equal  to  1? 

je  not_a_386 

/yES->  Not  an  80386  or  80286 

; —  Test  to  see  if  it 

should  be  handled  as  80386  or  80286  — 

mov  dl,p_80286 

/This  narrows  it  down  to  one  of  the 

inov  ax,07000h 

/two  processors 

push  ax 

/Push  value  07000H  onto  the  stack 

popf 

/Return  as  flag  register 

pushf 

/and  push  back  onto  stack 

pop  ax 

/Pop  off  and  return  to  AX  register 

and  ax, 07000h 

/Do  not  mask  bits  12-14 

je  pende 

/Are  bits  12-14  equal  to  0? 

/YES->  Treat  it  as  an  80286 

inc  dl 

/NO->  Treat  it  as  an  80386 

jmp  pend 

/Test  ended 

Test  for  80186  or  80188  - 

not  a  386  label  near 


mov 

mov 

mov 

shr 

jne 

dl,p  80188 

al,0ffh 

cl,021h 

al,cl 

t88_86 

Test  for  NEC  V20  < 

/Load  code  for  80188 

/Set  all  bits  in  AL  register  to 

/Number  of  shift  operations  after  CL 

/Shift  AL  CL  times  to  the  right 

/If  ALOO  then  it  must  be  handled  as 

/ 80188  or  80186 

3r  V30 

* 

mov 

dl,p  v20 

/Load  code  for  NEC  V20 

sti 

/Interrupts  should  be  enabled  starting 

mov 

si,  0 

/with  the  first  byte  in  ES 

mov 

cx,0ffffh 

/Read  a  complete  segment 

rep 

lods  byte  ptr  es: 

:[si]  /REP  with  segment  override 

/works  only  with  NEC  V20/V30  chips 

or 

cx,  cx 

/Has  the  complete  segment  been  read? 

je 

t88_86 

;YES— >  it's  a  V20  or  V30 

mov 

dl,p_8088 

/NO — >  must  be  an  8088  or  8086 

Test  for  ...88  or 

...86  /  V20  or  V30  - 

label  near 

push 

cs 

/Push  CS  onto  the  stack 

pop 

es 

/and  pop  off  to  ES 

std 

/Using  string  inst.  count  backwards 

mov 

al,  Ofbh 

/Code  for  "STI" 

mov 

cx,  3 

/Execute  string  instruction  3  times 

call 

getdi 

/Call  starting  address  DI 

cli 

/Suppress  interrupts 

rep 

stosb 

cld 

/Using  string  Inst,  ocunt  backwards 

nop 

nop 

nop 

/Fill  queue  with  dummy  command 
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q_end: 

Inc  dx 

nop 

sti 

;Incranent  processor  code 

; Re-enable  interrupts 

pend 

9 

label  near 

;End  processor  test 

xor  dh,  dh 
mov  di,  [1:^6] 
mov  [di],dx 
pop  es 
popf 
pop  )ap 
ret  2 

;Set  high  byte  or  processor  code  to  0 
;Get  addr.  of  processor  code  variables 
/Place  processor  code  in  this  variable 
;Pop  off  stack  and  place  in  ES 
;Pop  flag  register  off  of  stack  and 
/Return  BP 

/FAR  return  takes  us  back  to  Gff-BASIC 
/Remove  parameters  from  stack 

getproc 

endp 

/End  of  PROG  procedure 

GET_DI  Check  with  DI  for 

88/86  Test  - 

get_dl 

proc  near 

pop  di 
add  di,9 
jnp  t86_l 

/Pop  return  address  off  of  stack 
/Remove  starting  9  bytes  from  it 
/Return  to  the  test  routine 

getjdi 

endp 

code 

ends 

end  getproc 

/End  of  CODE  segment 

listing: 

PROCP.PAS 

I ************************* ***************************************** 

{*  P  R  O  C  P  *} 

{*  Task  :  Examines  the  processor  type  in  the  PC  and  *} 

{*  tells  the  user  the  processor  type  *} 

- *j 

{*  Author  :  MICHAEL  TISCHER  *} 

{*  Developed  on  :  08/16/1988  *} 

{*  Last  update  :  05/23/1989  *} 

{★*★★*★*★*★★★★*★*★*★★*★****«******«***★*★★*★*★*★★*★***★***********★*★*★ j 


program  PROCP; 


type  ProNames  *  array [0.. 7] 

of  string[ll]; 

{  Array  of  processor  names  } 

const  ProcName  :  ProNames  * 

(  'INTEL  8088', 

{  Code  0  } 

•INTEL  8086', 

{  Code  1  } 

•NEC  V20', 

{  Code  2  } 

•NEC  V30', 

{  Code  3  } 

•INTEL  80188', 

{  Code  4  } 

•INTEL  80186', 

{  Code  5  } 

•INTEL  80286', 

{  Code  6  } 

•INTEL  80386' 

);  {  Code  7  } 

^  **********  **************it****-k**it  ******************************  *******  i 

{*  GETPROC:  Determines  processor  type  in  PC 

*} 

{*  Input  :  none 

*} 

{*  Output  :  Processor  code 

(see  CONST) 

*) 

{*  Info  :  This  function  can  be  used  in  a 

program  when  added  as  *} 

{*  a  UNIT 

*} 

I  **-k^-k*  ***********  1fk*-kifk-k1fkit1t1tic-k1r  *********  It******  ir**it***  ******** -kltlt****  J 

function  getproc  :  byte; 

begin  {  Machine  code  routine  for  determining  processor  type  } 
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inline ( 

$9C/$51/$52/$57/$56/$06/$33/$C0/$50/$9D/$9C/$58/$25/$00/ 

$F0/$3D/$00/$F0/$74/$13/$B2/$06/$B8/$00/$70/$50/$9D/$9C/ 

$58/$25/$00/$70/$74/$36/$FE/$C2/$EB/$32/$90/$B2/$04/$B0/ 

$FF/$Bl/$21/$D2/$E8/$75/$12/$B2/$02/$FB/$BE/$00/$00/$B9/ 

$FF/$FF/$F3/$26/$AC/$0B/$C9/$74/$02/$B2/$00/$0E/$07/$FD/ 

$BO/$FB/$B9/$03/$00/$E8/$16/$00/$FA/$F3/$AA/$FC/$90/$90/ 

$90/$42/$90/$FB/$88/$56/$FF/$07/$5E/$5F/$5A/$59/$9D/$EB/ 

$07/$90/$5F/$83/$C7/$09/$EB/$E4 

); 

end; 


{**  MAIN  PROGRAM  **) 

begin 

writelnC  PROOF  -  (c)  1988  by  MICHAEL  TISCHER' )  ; 

writeln(#13#10,  'Your  PC  contains  a(n)  ProcName [getproc] , 

'  processor . ' ) ; 
writeln (#13#10)  ; 
end. 

Assembler  listing:  PROCPA.ASM 

■★*★*★*★*★*★*****★**************«*****************************★*★****★*> 


•  * 

P  R  0  C  P  A 

*  • 
9 

7 

•  ★ 
r 

Task 

:  Determines  the  type  of  processor  installed  in 

9 

★  • 

a  PC. 

★  • 
9 

This  version  is  converted  by  INLINE  statements 

*; 

and  then  used  by  a  Pascal  program. 

★  • 

9 

Author 

:  MICHAEL  TISCHER 

9 

9 

•  * 

Developed  on 

:  08/22/1988 

t 

.  * _ 

Last  update 

:  05/24/1989 

*• 

■ 

t 

•  * 

assembly 

:  MASM  PROCPA; 

*; 

t 

LINK  PROCPA; 

★  • 
t 

t 

EXE2BIN  PROCPA  PROCPA.BIN 

*  • 

•  * 

. . .  convert  to  INLINE  stat&nents  and  add  to 

*; 

•  * 

Pascal  programs 

*; 

J  *****************  *********i,****ic*  *************************************  . 


;==  Const 

p  80386 

ants  = 

equ 

7 

; Codes  for  different  types  of 

p  80286 

equ 

6 

; processors 

p  80186 

equ 

5 

p  80188 

equ 

4 

p__v30 

equ 

3 

p  v20 

equ 

2 

p  8086 

equ 

1 

p_8088 

;==  Code 

equ 

0 

code 

segment  para  'CODE' 

'  ; Definition  of  CODE  segment 

org 

lOOh 

assume  cs:code,  ds: 

:  code,  ss : code ,  es  ;dode 

getproc 

proc 

near 

;This  program  is  the  essential  main 
; program 

pushf 

;Get  contents  of  flag  registers 

push  cx 

;Get  contents  of  all  altered  registers 

push  dx 
push  di 

;and  push  them  onto  stack 
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push  si 
push  es 

; —  Test  for  80386/80286 


xor 

ax,  ax 

/Set  AX  to  0 

push  ax 

/and  push  onto  stack 

popf 

/Pop  into  flag  register  frcxn  stack 

pushf 

/Return  to  stack 

pop 

ax 

/And  pop  back  into  AX 

and 

ax, OfOOOh 

/Avoid  clearing  the  to  4  bits 

cmp 

ax, OfOOOh 

/Are  bits  12-15  all  equal  to  1? 

je 

not_a_386 

/YES->Not  an  80386  or  an  80286 

/ —  Test  whether 

to  handle  it  as  an  80386  or  80286  - 

mov 

dl,p  80286 

/This  narrows  it  down  to  one  of 

mov 

ax, 07000h 

/the  two  processors 

push  ax 

/Push  value  7000H  onto  the  stack 

popf 

/Pop  off  as  flag  register 

pushf 

/and  push  it  back  onto  the  stack 

pop 

ax 

/Pop  off  and  return  to  AX  register 

and 

ax, 07000h 

/Avoid  masking  bits  12-14 

je 

pende 

/Are  bits  12-14  all  equal  to  0? 
/YES->Handle  it  as  an  80286 

inc 

dl 

/NO->Handle  it  as  an  80386 

jmp 

pende 

/End  of  test 

Test  for  80186  or  80188  - 

not_a_386  label  near 

mov  dl,p_80188 
mov  al,0ffh 
mov  cl,021h 
shr  al,cl 
jne  t88_86 


Test  for  NEC  V20 

mov  dl,p_v20 
sti 

mov  si,0 
mov  cx,0ffffh 

rep  lods  byte  ptr  es:[si)  ;REP  w/  segment  override  only 

/works  with  NEC  V20  and  V30  processors 
or  cx,cx  /Has  complete  segment  been  read? 

je  t88_86  /yES->  V20  or  V30 

mov  dl,p_8088  /NO->  Must  be  an  8088  or  8086 

/ —  Test  for  8088  or  8086/V20  or  V30  - 


/Load  code  for  80188 
/Set  all  bits  in  AL  register  to  1 
/Number  of  shift  operations  after  CL 
/Shift  AL  CL  times  to  the  right 
/If  AL  is  unequal  to  0  it  must  be 
/handled  as  an  80188  or  80186 

/Load  code  for  NEC  V20 
/Interrupts  should  be  enabled  starting 
/with  the  first  byte  in  ES 
/Read  a  complete  segment 


label  near 

push 

cs 

/Push  CS  onto  stack 

pop 

es 

/Pop  off  to  ES 

std 

/Using  string  inst.  count  backwards 

mov 

al,0fbh 

/Instruction  code  for  "STI** 

mov 

cx,  3 

/Execute  string  instruction  3  times 

call 

getdi 

/Get  starting  address  of  DI 

cll 

/Suppress  Interrupts 

rep 

stosb 

cld 

/Using  string  inst.  count  backwards 

nop 

/Fill  queue  with  dumny  instruction 

nop 

nop 
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q_end: 

Inc  dx 

nop 

stl 

/Increnent  processor  code 

; Re-enable  Interrupts 

pende 

9 

label  near 

;End  testing 

mov  [1:^1  l,dl 

pop  es 

pop  si 

pop  di 

pop  dx 

pop  cx 

popf 

jmp  endit 

; Place  processor  code  in  return  var. 
;Pop  saved  registers  from 
; stack 

;Pop  flag  register  from  stack  and 
; Return  to  calling  program 

getproc 

endp 

;End  of  PROG  procedure 

; —  GET_ 

_DI  examines  DI  for 

88/86  test  - 

get_di 

proc  near 

pop  di 
add  di, 9 
jmp  t86_l 

;Pop  return  address  off  of  stack 
;Take  first  9  bytes  from  there 
/Return  to  the  testing  routine 

endit 

label  near 

get_dl 

endp 

,  —  tino 

code 

ends 

end  getproc 

;End  of  CODE  segment 

C  listing:  PROCCX 


/★★★*★*****************★*** 


/*  P  R  0  C  C  V 

/* - */ 

/*  Task  :  Determines  the  processor  type  in  a  PC  */ 

/* - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  Developed  on  :  08/14/1988  */ 

/*  Last  update  :  06/22/1989  */ 

/* - */ 

/*  (MICROSOFT  C)  */ 

/*  Creation  :  CL  /AS  /c  PROCC.C  */ 

/*  LINK  PROCC  PROCCA  */ 

/*  Call  :  PROCC  */ 

/* - */ 

/*  (BORLAND  TURBO  C)  */ 

/*  Creation  :  Create  a  project  file  containing  these  lines:  */ 


/* 

/* 


PROCC 
PROCCA. OBJ 


*/ 

*/ 


/** 


*★★*★★*★* 


extern  int  getprocO 


/*  Includes  the  assembler  routine  */ 


/★★★★★*★★*★*★★★★★****★*★★*★★★★*★**★*★**★**★***★★*★**★*★★★★★★★★★★*★★★★*★/ 
/**  main  program  **/ 


void  mainO 


{ 

static  char  *  procname[] 


{  /*  Vector  w/  pointers  to  proc.  names  */ 
"Intel  8088",  /*  Code  0  */ 
"Intel  8086",  /*  Code  1  */ 
"NEC  V20",  /*  Code  2  */ 
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"NEC  vaO",  /*  Code  3  */ 

"Intel  80188",  /*  Code  4  */ 

"Intel  80186",  /*  Code  5  */ 

"Intel  80286",  /*  Code  6  */ 

"Intel  80386"  /*  Code  7  */ 

}; 

printf ("\nPROCC  (c)  1988  by  Michael  Tischer\n\n"> ; 
printf("This  PC  contains  a(n)  %s  processor\n", 
procnamet  getprocO  ]  ); 

} 

Assembler  listing:  PROCCA.ASM 


•★**★★★★★★★★★★★*★*★*★★★★**★**★*****★*★★★*★★*★★*★★★**★★★★**★*★★*★**★★*★★ . 

/*  P  R  0  C  C  A  *; 

.-k 

Task 

:  Make  a  function  available  to  a  C  program  which 

★  > 
/ 

examines  the  type  of  processor  installed  in  a 

•  ★ 

PC  and  informs  the  calling  program  of  this 

*  • 

;* 

information. 

*; 

•  ★ 

Author 

;  MICHAEL  TISCHER 

*; 

;★ 

Developed  on 

:  08/15/1988 

*; 

•  *  — 

Last  update 

:  05/24/1989 

* 

-*• 

r 

•  * 

assembly 

;  MASM  PROCCA/ 

★  • 

•  ■k 

...  link  to  a  C  program 

★  • 
f 

•  kk  *1t kkkit * k  ***************  kkkititkltk  *******  kkkkkkkic  it-kkkkk*  kkit-kkifltk *******  j 

IGROUP  group  Jtext  ; Include  program  segment 

DGROUP  group  const, _bss,  _data  /Include  data  segment 
assume  CS: IGROUP,  DS: DGROUP,  ES: DGROUP,  SS: DGROUP 

CONST  segment  word  public  'CCXJST' /This  segment  includes  all  read-only 
CONST  ends  /constants 

_BSS  segment  word  public  'BSS'  /This  segment  includes  al  un-initial- 
_BSS  ends  /ized  static  variables 

_DATA  segment  word  public  'DATA'  /This  segment  includes  all  Initialized 

/gobal  and  static  variables 

JDATA  ends 
/  ==  Constants 

p_80386  equ  7  /Codes  for  different  processor  tpyes 

p_80286  equ  6 

p_80186  equ  5 

p_80188  equ  4 

p_v30  equ  3 

p_y20  equ  2 

p_8086  equ  1 

p_8088  equ  0 

/  ~  Program  =======«========*===========*====*======*=======««==»»«»*“*«====== 

JTEXT  segment  byte  public  'CODE'  /Program  segment 

public  _getproc  /Function  made  available  for  other 

/programs 

/ —  GETPROC:  Determines  the  type  of  processor  in  the  current  PC  - 

/ —  Call  from  C  :  int  getproc(  void  )/ 

/ —  Output  :  The  processor  type's  number  (see  constants  above) 

jgetproc  proc  near 

pushf  /Secure  flag  register  contents 
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; —  Test  for  80386/80286  - 


xor 

ax,  ax 

/Set  AX  to  0 

push  ax 

/and  push  onto  stack 

popf 

/Pop  flag  register  off  of  stack 

pushf 

/Push  back  onto  stack 

pop 

ax 

/and  pop  off  of  AX 

and 

ax,0f000h 

/Do  not  clear  the  upper  4  bits 

cnp 

ax,0f000h 

/Are  bits  12-15  al  equal  to  1? 

je 

not_a_386 

/YES  — >  Not  an  80386  or  80286 

/ —  Test  for  handling  as  an  80386  or  80286  - 

mov 

dl,p  80286 

/In  any  case,  this  routine  checks  for 

mov 

ax,07000h 

/one  of  the  two  processors 

push  ax 

/Push  07000h  onto  stack 

popf 

/Pop  flag  register  off 

pushf 

/and  push  back  onto  the  stack 

pop 

ax 

/Pop  into  AX  register 

and 

ax,07000h 

/Bits  12-14  not  included 

je 

pende 

/Are  bits  12-14  all  equal  to  0? 

/YES~>  Handle  it  as  an  80286 

inc 

dl 

/NO  — >  Handle  it  as  an  80386 

jmp 

pende 

/End  test 

; —  Test  for  80186  or  80188 


not  a  386  label  near 


mov 

dl,p  80188 

/Load  code  for  80188 

mov 

al,0ffh 

/Set  all  bits  in  AL  register  to  1 

mov 

cl,021h 

/Move  number  of  shift  operations  to  CL 

shr 

al,cl 

;AL  CL  shift  to  the  right 

jne 

t88  86 

/If  AL  <>  0,  handle  is  as  an 

/ 80188  or  80186 

_ 

Test  for  NEC  V20 

mov 

dl,p  v20 

/Load  code  for  NEC  V20 

sti 

/Enable  interrupts 

push  si 

/Mark  contents  of  SI  register 

mov 

si,0 

/Starting  with  first  byte  in  ES,  read 

mov 

cx,0ffffh 

/a  ccxnplete  segment 

rep 

lods  byte  ptr  es 

i:[si]  /REP  with  a  segment  override 

/ (works  ony  with  NEC  V20,  V30) 

pop 

si 

/Pop  SI  off  of  stack 

or 

cx,  cx 

/Has  entire  segment  been  read? 

je 

t88_86 

/YES— >  V20  or  V30 

mov 

dl,p_8088 

/NO  — >  Must  be  8088  or  8086 

Test  for  88/86  or  V20/V30 - 


t88_86  label  near 

push  cs 
pop  es 
std 

mov  di, offset  q_end 
inov  al,0fbh 
mov  cx,3 
cli 

rep  stosb 

old 

nop 

nop 

nop 

Inc  dx 


;Push  CS  onto  stack 
;and  pop  ES  off 

;Incranent  on  string  instructions 

f 

/Instruction  code  for  "STI" 

/Execute  string  instruction  3  times 
/Suf^ress  interrupts 

/Increment  on  string  instructions 
/Fill  queue  with  dumny  instructions 


/Increment  processor  code 


665 


15.  Determining  Processor  Types 


PC  System  Programming 


q_end: 

nop 

sti 

; Re-enable  Interrupts 

pende 

label  near 

;End  testing 

popf 

xor  dh, dh 
mov  ax, dx 
ret 

;Pop  flag  register  off  of  stack 
;Set  high  byte  of  proc.  code  to  0 
/Processor  code-return  value  of  funct. 
/Back  to  caller 

_getproc 

P.nd  ■ 

endp 

/End  of  procedure 

;End  of  program  segment 
;End  of  ass&nbler  source 


text  ends 
end 
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Now  that  you're  more  familiar  with  the  DOS  and  BIOS  intorupts  that  are  triggered 
by  software,  let's  look  at  hardware  interrupts.  As  the  term  suggests,  these 
intorupts  operate  mainly  through  calls  from  PC  hardware. 

Well  begin  with  the  interrupts  which  are  called  directly  by  the  processor.  These 
eight  interrupts  can  also  be  triggered  by  software  through  the  use  of  the  INT 
instruction. 

Interrupt  OOH:  Division  by  zero 

The  8088  has  two  assembly  language  instructions  (DIV  and  IDIV)  which  permit 
division  of  a  16-bit  or  32-bit  whole  number  by  an  8-bit  or  a  16-bit  whole  number. 
According  to  the  general  rules  of  mathematics,  division  by  zero  is  illegal.  This 
means  that  you  cannot  perform  the  equation  485/0.  The  equation  has  no  result 
Because  of  this,  the  8088  prohibits  any  divisions  using  a  denominator  of  0.  If  a 
division  by  zero  occurs,  the  processor  triggers  interrupt  0.  The  vector  assigned  to  it 
is  pointed  to  by  DOS  during  its  initialization  to  its  own  routine.  During  the  call 
of  this  intOTupt,  the  DOS  routine  call  executes.  Most  visions  of  DOS  display  a 
"Division  by  Zero"  message.  The  program  then  continues  with  the  instruction 
following  the  division  that  caused  the  error. 

Interrupt  01 H:  Single  step 

The  CPU  calls  this  interrupt  when  the  TRAP  bit  in  the  flag  register  of  the  CPU  is 
set  to  1.  The  interrupt  then  receives  a  call  after  every  execution  of  a  machine 
language  instruction.  This  interrupt  allows  the  uso’  to  trace  the  execution  of  every 
instruction  in  a  assembly  language  program  to  determine  changes  in  register 
ctmtents  or  the  instructions  executed. 

Constant  re-execution  of  interrupt  1  during  an  execution  of  interrupt  1  could  cause 
infinite  recursion,  and  an  eventual  stack  overflow.  To  prevent  this,  the  processor 
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resets  the  TRAP  bit  during  entry  into  the  intorupt  routine.  It  stores  the  complete 
flag  register  and  the  TRAP  bit  on  the  stack. 

If  an  IRET  instruction  ends  this  interrupt  routine,  it  automatically  sets  the  TRAP 
bit  to  the  old  value  by  restoring  the  complete  flag  register  from  the  stack.  After 
completion  of  the  next  instruction,  interrupt  1  is  tecaUed.  Chice  the  programmer 
has  obtained  all  desired  information  about  the  program,  the  TRAP  bit  can  be 
disabled.  However,  the  program  being  examined  doesn't  know  it's  being  run  in 
single-step  mode,  and  has  no  instruction  to  reset  the  TRAP  bit  in  the  flag  regista*. 

Resetting  the  TRAP  bit 

The  key  to  this  problem  lies  in  interrupt  Ts  routine.  This  is  whCTe  the  TRAP  bit 
must  be  reset.  Even  this  is  somewhat  complicated,  since  the  bit  was  reset  during 
the  call  of  this  routine,  then  lata  reset  as  part  of  the  flag  register  from  the  stack. 
The  only  option  of  resetting  the  TRAP  bit  is  taking  the  flag  register  from  the 
stack  from  within  the  interrupt  routine,  resetting  the  TRAP  bit  and  return  the 
complete  flag  register  to  its  original  position  on  the  stack.  If  an  IRET  instruction 
then  terminates  the  int^rupt  routine,  the  CPU  restores  the  flag  register  from  the 
stack.  Since  the  TRAP  bit  is  no  longer  set,  no  additional  calls  of  interrupt  routine 
result,  and  the  program  executes  undisturbed. 

Interrupt  1  is  rarely  executed  in  application  programs.  Because  of  this,  DOS  sets 
the  vector  of  interrupt  1  to  an  IRET  instruction.  If  a  program  accidentally  sets  the 
TRAP  bit,  nothing  happens  aside  from  slower  execution,  since  interrupt  1 
executes  after  every  instruction.  Interrupt  1  is  most  useful  in  utility  programs 
(e.g.,  the  DEBUG  program)  which  permit  program  execution  in  trace  mode,  i.e., 
execution  of  every  machine  language  instruction  at  slow  speed. 

Interrupt  02H:  NMI 

This  non-maskable  interrupt  (NMI)  is  so  designated  because  it  cannot  be  masked 
(i.e.,  you  cannot  prevent  this  interrupt's  execution).  You  can  suppress  the 
execution  of  all  interrupts  using  the  CLI  instruction,  exc^t  this  one.  NMI  alerts 
the  user  of  any  errors  in  RAM.  These  errors  can  be  caused  by  defects  in  one  of  the 
system's  RAM  chips.  Since  a  defective  RAM  chip  can  cause  serious  damage  and 
data  problems  in  the  system,  this  interrupt  receives  top  priority  over  all  others. 

During  the  system  boot,  DOS  points  the  vector  to  its  own  routine.  If  a  RAM  error 
does  occur,  this  calls  the  proper  BIOS  routine  which  displays  a  message  on  the 
screen  and  stops  the  system. 

Interrupt  OSH:  Breakpoint 

This  interrupt  is  also  used  in  utility  programs.  Unlike  the  other  interrupts,  which 
are  called  by  two-byte-long  assembly  language  instructions  (byte  IsCDH,  byte 
2=interrupt  number),  interrupt  3  can  be  called  with  a  single-byte  assembly 
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language  instruction  (CCH).  This  interrupt  is  very  useful  fw  testing  programs  up 
to  a  certain  point  in  the  code.  Interrupt  3  halts  a  running  [Hogram,  and  allows  the 
user  to  examine  the  cunrat  contoits  of  the  registers. 

Applying  interrupt  3  ^ 

Using  a  q)ecific  utility  program  for  reference  (e.g..  DEBUG),  you  place  a  call  for 
interrupt  3  in  the  program  in  process  where  you  want  execution  to  stop.  When  the 
processor  reaches  this  location  during  program  execution,  it  calls  intorupt  3.  The 
testing  program  contains  a  routine  which  displays  the  curroit  registo'  contents  and 
other  data.  Then  this  routine  replaces  the  interrupt  3  call  with  the  instruction 
which  formo-ly  occupied  its  location. 

You  could  argue  that  instead  of  the  call  for  intonipt  3,  any  other  interrupt  could  be 
called  to  intemq)t  the  program,  if  a  suitable  intmupt  routine  had  been  installed  to 
display  register  contents,  etc.  Intorupt  3  pffors  some  advantages  ovo'  this.  It  can 
be  called  with  a  single-byte  instruction.  ^ 

Imagine  a  program  in  which  a  RET  instruction  occurs  at  some  location.  This 
instruction  is  one  byte  long  and  normally  ends  a  subroutine.  Another  subroutine 
follows  which  starts  with  an  assembly  language  instruction.  The  user  wants  to 
examine  the  register  contrats  at  the  end  of  the  first  subroutine.  He  would  place  a 
breakpoint  (the  call  for  intorupt  3)  at  the  same  location  as  the  RET  instruction. 

The  single-byte  instruction  to  call  interrupt  3  has  an  advantage  here.  If  this 
instruction  was  two  or  more  bytes  long,  it  would  overwrite  the  RET  instruction, 
and  part  or  all  of  the  first  instruction  in  the  following  subroutine.  If  this  program 
call  occurred  in  the  course  of  execution,  the  program  code  would  change  and  a  crash 
could  ht^pra.  This  doesn't  haiq)en  since  the  instruction  fw  calling  intorupt  3  is 
only  one  byte.  At  worst  it  would  overwrite  only  one  instruction. 

This  intmupt  has  no  triplication  other  than  use  with  a  testing/debugging  utility. 
Othowise,  DOS  points  to  a  routine  which  contains  an  IRET  (Interrupt  RETum) 
instruction,  which  immediately  returns  the  syston  to  the  interrupted  program. 

Interrupt  04H:  Overflow  error 

This  interrupt  can  be  called  by  a  instruction  which  is  based  on  a  condition.  It's  the 
INTO  (INTerrupt  on  Overflow)  astombly  language  instruction  which  only  calls 
interrupt  04H  when  a  set  ovoflow  bit  occurs  in  the  flag  legists  during  execution. 
This  can  happen  after  math  <q>aations  (e.g.,  multiplication  using  the  MUL 
instruction),  if  the  result  of  this  operation  caimot  be  represented  within  a  set 
number  of  bits.  Hiis  intmupt  can  also  be  called  using  the  normal  INT  instruction, 
but  this  instruction  doesn't  read  the  status  of  the  overflow  bit  Since  this  interrupt 
is  seldom  used,  DOS  sets  it  to  an  IRET  instruction. 
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Interrupt  OSH:  Hardcopy 

Interrupt  OSH  belongs  with  the  BIOS  intompts,  even  though  it  is  technically  a 
hardware  interrupt  Pressing  the  <Prt  So  key  calls  this  interrupt  through  BIOS. 
This  key  has  labels  which  differ  from  one  manufacturer  to  anotho'.  The  Tandy 
1000  HD  version  is  labeled  <PRINT>,  but  most  others  have  <PrtSc>  labels.  This 
key  soids  the  current  contents  of  the  screen  to  a  printo*  interfaced  to  the  PC.  This 
printout  is  called  hardcopy. 

DOS  initializes  the  vector  of  this  interrupt  in  the  vector  table.  Both  assembly 
language  programs  and  programs  written  in  high  level  languages  can  access  this 
interrupt  using  the  INT  instruction. 

Interrupts  06H— 07H:  Unused 

At  the  time  of  this  writing,  interrupts  06H  and  07H  are  unused.  They  are  resowed 
for  lato  use,  but  can  be  used  now  for  other  applications. 

Interrupts  08H— OFH 

Interrupts  OSH  to  OFH  are  genoated  by  the  8259  interrupt  controller.  This  chip 
receives  all  interrupt  demands  within  the  system  first  It  detomines  the  priority  in 
which  multiple  interrupt  requests  must  be  executed.  The  interrupt  given  highest 
priority  passes  through  the  INTR  line  to  the  CPU.  Up  to  eight  interrupt  sources 
(devices)  can  be  connected  to  the  8259,  with  each  device  assigned  a  different 
priority.  With  the  help  of  the  interrupt  bits  in  the  flag  register,  the  CPU  can 
suppress  all  interrupt  calls  from  the  8259  (excqrt  NMI  intorupt  2 — ^see  above). 

Interrupt  generation  frmn  special  equipment  can  be  prevented.  For  this  the  intorupt 
mask  register  of  the  8259  must  be  accessed  through  port  21H.  The  eighth  bit  of 
this  register  is  connected  to  the  maximum  of  eight  devices  which  create  interrupts. 
Bit  0  r^resents  device  0,  bit  7  the  device  with  the  number  7.  If  a  bit  has  the  vtdue 
0,  the  CPU  receives  the  interrupt  calls  generated  by  the  device  assigned  to  it  from 
the  8259.  If  it  contains  the  value  1,  the  interrupt  calls  ate  suppressed.  If  several 
interrupt  calls  occur  at  the  same  time,  the  device  which  is  connected  to  bit  0  gets 
the  highest  priority  and  bit  7  the  lowest  priority.  If  the  highest  priority  interrupt 
has  been  processed,  theoretically  the  interrupt  with  the  next  priority  down  can  be 
transmitted  from  the  8259  to  the  CPU. 

Interrupt  instruction  register 

The  8259  knows  about  the  completion  of  an  interrupt  call  through  its  interrupt 
instruction  register  at  port  address  20H.  This  register  enables  communication 
between  a  program  and  the  8259.  When  an  interrupt  initiated  by  a  device  attached 
to  the  8259  finishes  processing,  it  must  send  an  OUT  assembly  language 
instruction  which  transmits  the  value  20H  (an  EOI  =  End  Of  Interrupt)  to  this 
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port  This  tells  the  8259  that  interrupt  processing  is  done,  and  the  next  interrupt 
can  be  called. 

The  bit  assignment  in  the  interrupt  mask  registers  (i.e.,  device  assignments  and 
priorities)  differ  between  individual  members  of  the  PC  family.  You  can  usually 
assume  that  the  device  connected  to  bit  0  of  the  interrupt  mask  register  triggas 
interrupt  OSH.  The  device  connected  to  bit  1  triggers  interrupt  09H,  etc.  Interrupt 
OFH  (the  last  intmupt  called  by  the  8259)  is  triggered  by  the  device  attached  to  bit 
7  of  the  interrupt  mask  register.  Generally  these  eight  intmnpts  have  designations 
of  IRQO,  etc.  up  to  IRQ7.  IRQ  stands  for  Interrupt  ReQuest. 

AT  interrupt  controllers 

The  AT  has  two  8259  interrupt  controllers,  so  it  can  control  up  to  16  interrupt 
sources.  The  interrupts  in  the  second  controller  have  designations  ranging  from 
IRQ8  to  IRQ15.  If  an  interrupt  request  is  made  from  one  of  the  eight  interrupt 
sources  of  the  second  interrupt  controller,  it  simulates  the  request  from  a  device 
connected  to  bit  2  of  the  first  interrupt  controllers.  Because  of  this,  all  interrupt 
requests  from  the  second  interrupt  controller  have  a  higher  priority  than  those  fixm 
devices  4  to  7  of  the  first  interrupt  controllers.  If  several  devices  demand  attention 
from  the  second  interrupt  controller,  it  services  the  interrupt  source  with  the 
highest  priority,  which  is  the  one  connected  to  the  lowest  bit  in  the  interrupt  mask 
register. 

Interrupt  requests  from  the  devices  on  the  second  interrupt  controller  can  be 
suppressed  by  manipulating  the  corresponding  bits  in  the  interrupt  mask  registor. 
This  register  is  located  at  port  address  AlH,  not  at  21H  like  the  first  intenupt 
controller.  The  interrupt  instruction  register  of  the  second  intmupt  controller,  to 
which  the  EOI  instruction  must  be  sent  after  the  completion  of  the  intorupt  from 
this  controller,  is  at  address  AOH  instead  of  20H.  In  addition  to  the  EOI  instruction 
to  the  second  interrupt  controller,  an  EOI  instruction  must  be  sent  to  the  first 
interrupt  controller  on  port  20H  at  the  end  of  the  interrupt  routine.  This  results 
from  the  interconnection  between  these  two  controllers,  since  every  interrupt 
request  to  the  second  interrupt  controller  triggers  an  interrupt  request  on  the  first 
intOTupt  controller. 
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The  fdlowing  figures  show  the  intmupt  request  devices  and  their  priorities. 
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Interrupt  OSH:  Timer 

The  PC's  8253  timer  chip  oscillates  at  1,193,180  cycles  per  second.  It  receives  its 
signal  from  the  8284A  clock  goierator  chip.  After  65,536  of  these  signals  (about 
18.2  cycles  per  second),  it  calls  interrupt  08H,  which  the  8259  transmits  to  the 
CPU.  Since  the  occurrence  of  these  interrupt  calls  is  independent  of  the  clock 
frequency,  this  interrupt  works  well  for  time  measuremoit.  After  18.2  calls  means 
that  a  second  has  elapsed.  BIOS  points  the  interrupt  vector  of  this  interrupt  to  its 
own  routine,  which  is  called  18.2  times  per  second.  The  routine  increments  the 
time  counter  at  every  call  and  switches  off  the  disk  motor  if  no  access  to  the  disk 
has  occurred  within  a  cotain  span  of  time.  Afto*  this  task  has  been  completed,  the 
routine  calls  interrupt  ICH.  It  can  be  accessed  by  the  user  for  routines  which 
dqtend  upon  a  continuous  signal. 

Interrupt  OSH:  Keyboard 

The  keyboard  has  either  an  Intel  8048  processor  (for  PC/XT)  or  an  8042  processor 
(for  AT).  It  controls  the  keyboard  and  registers  if  a  key  was  pressed,  released  or 
pressed  and  held.  The  keyb^d  chip  sends  a  signal  to  the  8259,  which  causes  the 
CPU  to  call  interrupt  09H  (unless  an  interrupt  request  with  a  higher  priority  is 
present).  The  CPU  calls  a  BIOS  routine  which  reads  the  character  from  the 
keyboard  and  stores  it  in  the  keyboard  buffo'. 
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Interrupts  OAH — OCH:  Various 

These  interrupts  vary  with  the  hardware  connected  to  the  computer.  Check  your 
technical  manuals  and  hardware  manuals  fw  more  information,  and  expoimoit 

Interrupt  ODH:  Hard  disk 

The  system  calls  interrupt  ODH  if  a  hard  disk  is  connected  to  the  computer.  This 
occurs  when  a  read  or  write  opoation  ends  and  BIOS  must  be  informed  of  this  fact 

Interrupt  OEH:  Disk 

The  disk  controller(s)  calls  this  interrupt  in  conjunction  with  the  8259  when  the 
controll^  needs  the  attention  of  the  CPU.  A  BIOS  routine  following  this  intorupt 
communicates  on  the  lowest  level  with  the  controller.  During  the  call  of  this 
interrupt,  the  controllm'  passes  cmlain  information  to  inform  BIOS  that  a  read  or 
write  operation  was  completed,  or  an  oior  occurred. 

Interrupt  OFH:  Printer 

A  parallel  printer  calls  this  interrupt  in  conjunction  with  the  8259  when  the 
controller  needs  the  attention  of  the  CPU. 

AT  interrupts 

Because  of  the  second  interrupt  controller  in  the  AT,  it  has  more  hardware 
interrupts  than  the  PC  or  XT.  This  second  interrupt  controller  can  call  intomipts 
70H  to  77H.  These  interrupts  were  available  to  older  PCs  for  application 
programs.  Recently  manufactured  PCs  and  XTs  cannot  use  these  interrupts. 
Similar  to  the  first  interrupt  controller,  the  device  connected  with  bit  0  of  the 
second  interrupt  controllm''s  interrupt  mask  triggers  interrupt  70H.  The  device  on 
bit  1  calls  interrupt  71H,  bit  2  calls  interrupt  72H,  etc. 

Only  intmrupts  70H  and  75H  are  called  by  the  interrupt  controller  because  devices 
are  only  connected  to  bits  0  and  5  of  the  interrupt  mask  register.  Howeva,  the 
interrupt  vectors  of  interrupts  71H  to  74H  and  76H  and  77H  should  not  be 
redirect^ 

Interrupt  70H:  Realtime  clock 

Interrupt  70H  can  stop  a  program  because  of  alarm  time,  the  current  time  and  date, 
or  just  an  interrupt  call  repeated  within  a  certain  time  span.  The  interrupt  is 
normally  serviced  by  a  BIOS  routine  which  detects  the  reason  for  the  intranipt  then 
responds  accordingly. 
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Interrupt  75H:  Math  coprocessor 

Intemipt  7SH  infOTins  the  ATs  CPU  that  a  mathematical  coprocessor  (80287) 
attached  to  the  system  requires  attention  (e.g..  because  it  has  completed  a  certain 
calculation). 

Interrupt  76H:  AT  hard  disk 

The  AT  hard  disk  controller  calls  this  intmupt  after  completing  a  hard  disk  access. 
Demonstration  programs 

The  two  sample  programs  below  demonstrate  some  of  the  hardware  intrarupts 
described  in  this  chapter.  Both  programs  are  resident  intorupt  drivers  which  are 
installed  and  deactivated  using  the  same  principles  as  demonstrated  by  programs 
earlio*  in  this  book. 

The  first  program  displays  the  current  time  in  the  uppo*  right  comer  of  the  display 
screen.  The  second  program  sends  the  contents  of  a  screen  to  a  file  instead  of  a 
printer. 

Clock  timing 

Before  discussing  each  program's  stmcture,  you  should  know  about  the  basic 
principles  of  the  clock.  Interrupt  ICH  implements  the  clock.  Timer  interrapt  8H 
calls  intmupt  ICH  18.2  times  per  second. 

When  this  routine  counts  the  numbo'  of  calls  that  occur,  it  knows  that  exactly  one 
second  ehq)ses  after  18.2  calls,  and  that  it  must  display  the  time  on  the  screen  once 
every  second.  This  is  great,  except  that  the  clock  can  count  one,  two,  even  18 
calls — but  not  18.2  calls. 

One  solution  would  be  to  have  the  clock  update  the  screen  display  after  18 
interrupt  calls.  This  would  result  in  the  clock  running  fifteen  minutes  fast  every 
day.  You  can  solve  this  problem  using  a  trick  that  we  use  in  everyday  living.  Our 
year  doesn't  have  exactly  36S  days.  Every  four  years  the  calender  has  a  le^  year, 
which  keq>s  om  dates  on  schedule  with  Earth's  retime  clock. 

The  PERMCLK  program  does  something  similar  with  the  clock.  After  18  calls  of 
the  tima*  interrupt  routine,  the  clock  advances  one  second  and  the  new  time  ^>pears 
on  the  screen.  IlierefcHe,  the  time  advances  by  five  seconds  after  Sxl8  (90)  calls. 
Five  seconds  in  reality  equals  5x18.2  (91)  calls.  To  compoisate  for  the  missing 
call,  the  program  adds  a  sixth  second  after  19  calls.  This  makes  the  time 
measurement  more  accurate.  Since  a  second  actuaUy  ctHresponds  to  18.20648193 
calls,  the  clock  will  still  be  fast  by  a  few  seconds  after  a  day  passes.  To 
compensate  for  this,  an  additional  second  is  introduced  alter  20  calls.  This  makes 
the  clock  only  about  a  second  fast  within  a  24-hour  p^iod.  That's  fairly  accurate. 
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especially  when  you  consider  that  the  average  PC  doesn't  ranain  switched  on  for 
more  than  eight  hours  at  a  time. 
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*  • 
f 

* . 

* . 

t 

•  * 

Call 

:  PERMCLK 

r 

*  • 

j  *****************iHHHt  it*  ************************  • 


Constants 


CLKCOLUMN  »  72 
CLKLINE  -  0 
CLKNUM  -  6 
CLKCOLOR  -  70h 


/line  and  column  in  which  the  time 
;is  displayed 

/after  how  many  1/18  S.  is  the  clock  displayed 
/color  of  the  clock;  inverted 


/«=»  here  starts  the  actual  Program 


code  segment  para  'CODE*  /Definition  of  the  CCX)E-segment 

org  lOOh 


assume  cs:code,  ds:code,  esrcode,  ss:code 
start:  jmp  perminit  /Call  of  the  initialization  routine 


/—  Data 

(remain  in  memory  )  - 

alterint 

equ  this  dword 

/old  interrupt  vector  ICH 

intaltofs 

dw  (?) 

/offset  address  Interrupt  vector  ICH 

intaltseg  dw  (?) 

/segment  address  interrupt  vector  ICH 

time 

equ  this  byte 

/accepts  the  current  time 

tenhours 

db  (?) 

/lO  hours  as  ASCII 

onehour 

db  (?) 

/one  hours  as  ASCII 

db 

tenmlnt 

db  (?) 

/ten  minutes  as  ASCII 

onemln 

db  (?) 

/one  minutes  as  ASCII 

db 

tensecs 

db  (?) 

/ten  seconds  as  ASCII 

onesec 

db  (?) 

/one  seconds  as  ASCII 

t count 

db  18 

/decremented  on  every  timer-call 

numcount 

db  CLKNUM 

/display  counter  for  clock 

count 1 

db  5 

/correction  counter  1 

count 2 

db  31 

/correction  counter  2 

/“  this  is  the  new  keyboard-interrupt  (remains  in  memory  )  =»»»»—«»» 
newint  proc  far 

jmp  short  newtimer 

db  "JS"  /Identification  of  the  program 

newtimer:  push  ax  /record  all  registers  which  are  changed 
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push  bx 
push  cx 
push  dx 
push  dl 
push  si 
push  es 
push  ds 

push  cs 
pop  ds 

dec  numcount 
jne  nonum 

mov  numcount, CLKNUM 

nonum:  dec  t count 

je  nextsec 
cmp  numcount, 255 
jne  stl 
jmp  restore 

nextsec:  mov  tcount,18 
dec  count 1 
jne  settime 
mov  count 1,5 
Inc  t count 
dec  count 2 

jne  settime 
mov  count 2, 31 
inc  t count 

settime:  inc  onesec 

cmp  onesec, " : " 

stl :  jne  output 

mov  onesec,"©" 
inc  tensecs 
cmp  tensecs, "6" 
jne  output 
mov  tensecs,"©" 
inc  onemin 
cmp  onemin,":" 
jne  output 
mov  onemin, "©" 
inc  tenmint 
cmp  tenmint, "6" 
jne  output 
mov  tenmint,"©" 
inc  onehour 
cmp  onehour, " : " 
jne  test24 
mov  onehour,"©" 
inc  tenhours 
jmp  short  output 

test24:  cmp  onehour, "4" 

jne  output 
cmp  tenhours, "2" 
jne  output 
mov  tenhours,",©" 
mov  onehour,"©" 

output:  mov  ah, 15 
int  l©h 
mov  ah, 3 
int  l©h 
push  dx 


;by  the  program 


; store  CS  on  the  stack 
/return  as  DS 


/decrement  counter  for  display 
/not  yet  zero 

/set  to  original  value 

/already  called  18  times  ? 

/YES  — >  one  Second  passed 
/display  clock  now  ? 

/NO  — >  output 
/YES  — >  back 

/set  Call -counter  new 
/  correction-counterl  dec.  5  times  ? 
/NO  — >  increment  ASCII-time 
/YES  — >  set  to  5  again 
/increment  Call-counter 
/ correction-counter2 
/decremented  31  times? 

/NO  — >  Increment  ASCII-time 
/YES  — >  set  again  to  31 
/  increment  Cal 1-counter 

/increment  one  second  (ASCII) 

/one  second  «  1©? 

/NO  — >  output  time 
/set  one  second  to  zero 
/increment  ten  second  (ASCII) 

/ten  second  »  6  (6©  Seconds)? 

/NO  — >  output  time 
/set  ten  seconds  to  zero 
/increment  one  minute  (ASCII) 

/one  minute  «  1©? 

/NO  — >  output  time 
/set  one  minute  to  zero 
/increment  ten  minute  (ASCII) 

/ten  minute  =  6  (6©  Minutes) 

/NO  — >  output  time 
/set  ten  minute  to  zero 
/increment  one  hour  (ASCII) 

/one  hour  =1©? 

/NO  — >  test  24  hour 

/YES  — >  set  one  hour  to  zero 

/increment  ten  hour  (ASCII) 


/one  hour  -  4? 

/NO  — >  output  time 
/YES  — >  ten  hour  »  2? 
/NO  — >  output  time 
/a  new  day  started 


/read  current  display  page 
/call  BIOS  video-interrupt 
/read  current  cursor-position 
/call  BIOS  video-interrupt 
/store  on  stack 
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mov 

si, offset  time 

/offset  address  of  the  time-string 

roov 

cx,l 

/write  each  character  once 

mov 

dx,CLKLINE  Shi  8 

+  CLKCOLUMN  /cursor-position  for  time 

roov 

bl,CLKCOLOR 

/color  of  the  clock 

mov 

di,8 

/8  characters  are  output 

pritlme: 

mov 

ah,  2 

/set  cursor-position 

int 

lOh 

/call  BIOS  video-interrupt 

mov 

dh,CLKLINE  shl  8 

/repeat  line 

inc 

dl 

/increase  column  for  next  character 

roov 

ah,  9 

/output  a  character 

lodsb 

/get  character  from  the  string 

int 

lOh 

/call  BIOS  video-interrupt 

dec 

dl 

/all  characters  processed  ? 

jne  pritime 

/NO  — >  output  next  character 

pop 

dx 

/get  old  cursor-position 

roov 

ah,  2 

/and  set  again 

int 

lOh 

/call  BIOS  video- interrupt 

restore: 

pop 

ds 

/restore  all  recorded  registers 

pop 

es 

/again 

pop 

si 

pop 

di 

pop 

dx 

pop 

cx 

pop 

bx 

pop 

ax 

jmp 

cs: [alterint ] 

/jump  to  old  timer-interrupt 

newint 

endp 

Inst end 

equ  this  byte 

/if  SHOWCL  is  installed,  memory 

;can  be  released  from  here  on 
Data  (can  be  overwritten  by  DOS 

installm  db  13, 10,  "PERMCLK  (c)  1987  by  Michael  Tischer**,  13, 10, 13, 10 
db  "PERMCLK  was  installed  and  can  be  deactivated  **,13,10 
db  **through  a  new  Call**,13,10, **$** 

deactmsg  db  **PERMCLK  was  deactivated  **,13,10,**$** 

Program  (can  be  overwritten  by  DOS)  »*« 

; —  Start  and  Initialization  Routine  - 

perminit  proc  near 


roov 

ax, 351Ch 

/get  content  of  interrupt  vector  1C 

int 

21h 

/call  DOS- function 

crop 

word  ptr  es:[bx+21, 

**SJ**  /test  if  PERMCLK 

jne 

install 

/not  yet  installed  — >  install 

/—  1 

PERMCLK  deactivated 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

c 

•H 

(0 

O' 

mov 

dx,es:intaltofs 

/offset  address  of  interrupt  ICH 

mov 

ax, es:intaltseg 

/segment  address  of  interrupt  ICH 

mov 

ds,ax 

/to  DS 

mov 

ax, 251Ch 

/return  content  of  the  interrupt 

int 

21h 

/vector  ICH  to  old  routine 

roov 

ah,49h 

/release  the  storage  of  old 

int 

21h 

/PERMCLK  again 

push 

cs 

/store  CS  on  the  stack 

pop 

ds 

/return  as  DS 

roov 

dx, offset  deactmsg 

/message:  program  removed 

roov 

ah,  9 

/output  function  number  for  string 

int 

21h 

/call  DOS  function 
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mov  ax, 4C00h  ;code  for  program  executed  correctly 

int  21h  ;end  program  with  end-code 

Install  PERMCLK - 

install:  mov  intaltseg,es  ; segment  and  offset  address  of  the 

mov  lntaltofs,bx  /interrupt  vector  ICH 

mov  ah,02Ch  /read  function  number  for  time 

int  021h  /call  DOS  interrupt  21H 

mov  al,cl  /transmit  minute  to  AL 

mov  di, offset  tenmint  /ASCII  result  to  TENMINT 
call  binascii  /convert  2  nimbers  to  ASCII 

mov  al,ch  /transmit  hour  to  AL 

mov  di, offset  tenhours  /ASCII  result  to  TENHOURS 
call  binascii  /convert  2  numbers  to  ASCII 

mov  al,dh  /transmit  seconds  to  AL 

mov  di, offset  tensecs  /ASCII  result  to  TENSECS 
call  binascii  /convert  2  numbers  to  ASCII 

mov  dx, offset  newint  /offset  address  new  interrupt-routine 
mov  ax, 251Ch  /point  content  of  the  Interrupt 

int  21h  /vector  1C  to  user  routine 

mov  dx, offset  installm  /message:  program  installed 

mov  ah,  9  /output  function  number  for  string 

int  21h  /call  DOS-function 

/ —  only  the  PSP,  the  new  interrupt -routine  and  the  - 

/ —  Data  for  it,  must  retialn  resident 


mov 

dx, offset  instend 

/calculate  the  number  of 

mov 

cl,  4 

/paragraphs  (each  16  Bytes)  which 

shr 

dx,  cl 

/the  program  has  available 

inc 

dx 

mov 

ax,3100h 

/end  program  with  end-code  0  (o.k) 

int 

21h 

/but  remain  resident 

perminit  endp 

/ —  BINASCII  :  convert  binary-value  into  2-diglt  ASCII  - 

/ —  Input  :  AL  “  the  binary-value  to  be  converted 
/ —  DI  -  the  offset  address  for  the  2  ASCII  numbers 

/ —  Output  :  none 

/ —  Register  :  AX,  CL  and  FLAGS  are  changed 

binascii  proc  near 

xor  ah, ah 
mov  cl, 10 
dlv  cl 

or  ax,03030H 
mov  [dl],ax 
ret 

binascii  endp 

code  ends  /end  of  the  CODE-segroent 

end  start 

Installation  and  reinstallation  has  similarities  to  the  resident  interrupt  driver  already 
discussed.  It  installs  itself  during  its  first  call  and  deactivates  itself  on  the 
following  call. 


/HI-Byte  for  division  -  0 
/decimal  system  is  used 
/divide  value  by  10 
/convert  result  into  ASCII 
/and  store 
/back  to  caller 
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The  code  following  the  INSTALL  label  initializes  all  the  program’s  variables. 
First  the  DOS  function  2CH  reads  in  the  current  time,  converts  the  time  into 
ASCII  code  and  places  the  data  in  the  variables  TENHOURS,  TENMINT  and 
TENSECS.  These  variables,  which  are  part  of  an  ASCII  string,  act  as  buffers  for 
the  time  display  and  are  updated  once  every  seccxid.  After  these  variables  have  been 
initialized,  the  program  installation  takes  place. 

Let’s  lock  at  the  clock  itself,  the  new  interrupt  routine  of  interrupt  ICH.  It  begins 
in  the  listing  at  the  label  NEWINT.  It  jumps  to  the  label  NEWTIMER  to  bypass 
the  identification  code.  All  registers  changed  by  the  following  commands  are  stored 
on  the  stack.  Then  the  counter  (the  variable)  NUMCOUNT  is  decremented. 
NUMCOUNT  has  nothing  to  do  with  time  measurement;  it  determines  how  often 
to  display  the  time  on  the  screen.  Normally  the  clock  must  be  redisplayed  when 
the  time  has  changed  (every  second).  Since  the  screen  scrolls  in  some  applications 
(e.g.,  DOS),  the  clock  would  quickly  disappear  from  the  display.  To  display  a 
clock  that  looks  stationary,  it  must  be  redisplayed  more  often  than  once  a  second. 

When  NUMCOUNT  reaches  the  value  0,  this  means  that  the  clock  display 
reappears  with  the  following  commands,  even  if  a  new  second  hasn’t  occurred. 
After  NUMCOUNT  reaches  zero,  it  resets  to  its  original  value  so  that  it  can  be 
decremented  again  the  next  time  the  routine  is  called.  The  c^stant  CLOCKNUM 
contains  the  original  value  (6),  which  displays  the  clock  afte  6/18  second  (one- 
third  of  a  second).  You  may  preset  other  values  to  display  the  clock  more  or  less 
often. 

At  the  label  NONUM  the  counter  TCOUNT  decrements.  It  contains  the  numb^  of 
remaining  calls  until  a  second  has  elapsed.  If  the  number  is  equal  to  zero,  a  second 
has  elapsed  and  a  jump  occurs  to  the  label  NEXTSEC  where  it  resets  to  18  so  that 
the  next  second  can  be  displayed  after  18  calls. 

If  a  second  hasn’t  els^sed,  the  program  tests  for  whether  the  variable  NUMCOUNT 
reached  zero  and  resets  to  its  starting  value  during  this  call  of  the  timer  int^rupL  If 
this  was  the  case,  the  time  appears  on  the  screen  and  the  interrupt  ends.  If  the  time 
isn’t  displayed,  the  interrupt  can  be  ended  directly. 

After  NEXTSEC  resets  TCOUNT  to  18,  the  first  correction  counter  decrements.  If 
it  is  equal  to  zero,  it  means  that  five  seconds  have  elapsed  and  that  the  next  second 
can  only  be  initiated  after  19  calls.  The  TCOUNT  counter  increases  from  18  to  19 
and  the  first  correction  counter  resets  to  five.  Then  the  second  correction  counter 
decrements.  If  it  then  contains  the  value  zero,  then  31xS  seconds  have  passed  and 
the  next  second  can  only  be  initiated  aft^  20  calls. 

At  the  1^1  SETTIME,  incrementing  the  least  significant  digit  of  seconds  (one)  in 
the  variable  ONEMIN  sets  the  new  time.  A  test  is  made  for  the  start  of  a  new 
minute,  a  new  hour  or  a  new  day;  the  time  changes  accordingly. 
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The  label  OUTPUT  begins  the  actual  time  display.  OUTPUT  reads  the  current 
display  page  and  cursor  position.  This  data  passes  to  the  stack  so  it  can  be  restored 
after  the  time  is  displayed  on  the  screen.  The  cursor  moves  into  position  and  the 
program  displays  the  clock,  character  by  charact^. 

In  the  final  step,  the  previously  stored  current  cursor  position  is  removed  from  the 
stack  and  set  This  occurs  through  a  function  of  the  BIOS  video  interrupt. 

This  concludes  the  work  of  the  tim^  routine.  It  restores  the  registers  from  the 
stack,  passing  them  unchanged  to  the  interrupted  program.  It  finally  ends  with  a 
jump  to  the  old  timer  routine. 

The  HC2FILE  program 

The  second  sample  program  in  this  chs^ter  reroutes  hardcopy  data  to  a  file  instead 
of  a  printer.  The  program  requires  the  entry  of  the  program  name  and  the  path  and 
name  of  the  hardcopy  file.  This  name  can  contain  a  device  and  path  designation, 
but  must  have  a  three  digit  number  as  an  extension  (e.g.,  000  or  153).  A  sample 
call  would  look  like  this  from  the  DOS  prompt: 

C>hc2file  aihc.OOl 

You  would  then  press  <Shift><Pit  So  as  you  would  for  a  printed  screen 
hardcopy.  To  capture  hardcopies  in  sequence,  the  number  in  the  file  extension 
automatically  increments  afte  the  creation  of  every  hardcopy  file.  Fw  example,  the 
first  hardcopy  goes  to  a  file  named  HC.OOl  and  a  second  hardcopy  would  go  to  a 
file  named  HC.002.  During  output  the  individual  characters  are  read  from  the 
current  display  page,  but  their  colors  (an  attribute)  are  not  stored.  The  screen  lines 
in  the  file  write  to  disk  in  sequence  (no  carriage  returns  separate  lines).  You  can 
view  this  file  on  the  screen  using  the  DOS  TYPE  command. 

The  program  expects  a  filename  during  the  first  call  from  the  DOS  level.  If  you 
omit  the  filename,  the  HC2FILE  program  will  not  be  installed.  If  you  call  the 
program  again  after  its  installation  without  passing  a  filename,  it  deactivates  the 
installed  hardcopy  program  and  releases  the  memory  it  occupied.  If  the  program  is 
called  again  widi  a  filename  after  a  successful  inst^tion,  the  installed  hardcopy 
program  remains  active,  and  the  new  name  for  the  hardcr^y  file  takes  effect. 

Perhaps  the  new  hardcopy  interrupt  routine  may  be  of  interest.  You  call  it  after 
installation  by  in-essing  <Shift>  <Prt  So. 

First  it  determines  the  number  of  the  current  display  page  and  the  current  cursor 
position  using  a  function  of  the  BIOS  video  interrupt.  It  stores  these  on  the  stack, 
returning  them  to  BIOS  after  the  output  of  the  hard  copy.  Then  it  opens  the  file 
which  is  to  receive  the  hard  copy.  An  error  message  is  output  if  the  attempt  fails. 
In  the  next  step  the  display  screen  content  is  read  line  for  line  into  a  buffer 
(starting  at  the  beginning  of  the  PSP)  and  is  written  from  there  to  a  file.  Here  also 
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an  error  message  is  output  through  DOS  if  an  error  is  reptnrted  and  the  file  is 
erased. 

If  the  hardcopy  could  be  output  successfully,  the  file  is  closed  and  the  extension  of 
the  filename  (the  numbo'  of  the  hardcopy)  is  incremented.  Once  the  number  1,000 
is  reached,  the  numbering  restarts  at  0. 

Warning: 

An  important  restriction  during  the  use  of  this  program  must  be  observed.  It  can 
only  be  called  when  no  access  is  made  simultaneously  by  DOS  to  the  disk  or  hard 
disk.  If  the  new  hardcopy  is  called  during  the  DOS  access,  most  systems  will  crash 
because  DOS  is  not  capable  of  controlling  several  file  or  disk  accesses 
simultaneously.  DOS  is  not  re-^trant.  Remember  this  limitation  when  using  this 
routine,  because  it  cannot  be  bypassed. 

*  ****** *********************************■§,* **************************  • 


H  C  2  F  I  L  E 


■  ★ _ 

.  ★ 

Task 

:  Outputs  the  Hardcopy  of  an  80-column-text 

_★ 

★ 

>  ★ 

screen  in  a  file  instead  of  the  printer. 

* 

'  * 

The  file  must  have  a  three  digit  number 

* 

'  * 

as  extension  which  is  incremented  after 

★ 

★ 

the  output  of  the  hard  copy  so  that  several 

★ 

hard  copy  files  can  be  created  in  succession* 

★ 

WARNING 

:  after  installation  of  this  program 

* 

★ 

no  hard  copy  may  be  called  during 

★ 

* 

a  disk  or  hard  disk  access. 

* 

* 

The  system  will  crash  since  DOS  is  not 

* 

* 

★ _ 

reentrant ! 

* 

★ 

Author 

:  MICHAEL  TISCHER 

* 

* 

developed  on 

:  8.11.87 

* 

* 

* _ 

last  Update 

:  9.21.87 

* 

★ 

assembly 

:  MASM  HC2FILE/ 

* 

* 

LINK  HC2FILE/ 

* 

★ 

EXE2BIN  HC2FILE  HC2FILE.COM 

* 

* _ 

.* 

*  Call  :  HC2FILE  [ (Dr; )  (Path) Filename. zzz]  * 

**************************************************  if  i,***i^  If  i,**i,*i,**iti^ 


here  starts  the  actual  Program  »»««=»=»**==«==«=*«=*«=»==« 
code  segment  para  'CODE'  ;definitlon  of  the  CCX)E-segment 

org  lOOh 

assume  csrcode,  dstcode,  es:code,  ssrcode 

start:  jmp  hcinit  ;Call  of  the  Initialization- routine 

Data  (remain  in  storage)  **==«*==**==:====»===-==*===r=====x===*= 

alterint  equ  this  dword  ;old  Interrupt  vector  OSH 

Intaltofs  dw  (?)  /offset  address  Interrupt  vector  OSH 

intaltseg  dw  (?)  /segment  address  Interrupt  vector  OSH 

print  db  0  /indicates  if  printing  is  in  progress 

handle  dw  (?)  /Jcey  for  access  to  File 

hcerr  db  ''HC2FILE:  Error  on  output  of  the  hard  copy"^  13, 10,  *•$*' 
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this 

newint 

newhc: 

dohc: 


next line: 


error: 


datclose: 


is  the  new  hard  copy  interrupt  (remains  in  memory  ) 


proc 

far 

jmp 

short  newhc 

db  "RL" 

/Identification  of  the  program 

sti 

/interrupts  are  again  permitted 

cmp  ( 

cs:print,0 

/printing  in  progress? 

je  dohc 

/NO  — >  print  out 

jmp  newhcend 

/YES  — >  do  not  output  hard  copy 

mov 

cs: print, 1 

/print  now 

push 

ax 

/save  all  registers  which  are  changed 

push 

bx 

push 

cx 

push 

dx 

push 

di 

push 

si 

push 

es 

push 

ds 

mov 

ax,  cs 

/bring  CS  to  AX 

mov 

ds,ax 

/and  then  set  DS  and  ES 

mov 

es,ax 

cld 

/on  string  commands  count  up 

mov 

ah,  15 

/read  current  display  page 

int 

lOh 

/call  BIOS  video- Interrupt 

mov 

ah,  3 

/read  current  cursor-position 

int 

lOh 

/call  BIOS  video- interrupt 

push 

dx 

/store  on  the  stack 

mov 

ah, 3Ch 

/create  function  number  for  file 

xor 

cx,  cx 

/should  beccxne  nozmal  file 

mov 

dx, 130 

/filename  at  DS:130 

int 

21h 

/call  DOS-interrupt  21H 

jc 

error 

/carry-flag  set  — >  Error 

mov 

handle, ax 

/save  handle  of  the  file 

mov 

bl,-l 

/begin  with  line  0 

inc 

bl 

/increment  line  number 

cmp 

bl,25 

/all  lines  printed  ? 

je 

datclose 

/YES  — >  close  file 

call 

hcline 

/NO  — >  output  a  line 

jnc 

next line 

/no  error  — >  next  line 

mov 

ah,  3Eh 

/close  function  nr.  for  file 

mov 

bx, handle 

/access-key 

int 

21h 

/call  DOS-interrupt  21H 

mov 

ah,41h 

/erase  function  nr.  for  file 

mov 

dx, 130 

/filename  at  DS:130 

int 

21h 

/call  DOS-interrupt  21H 

mov  dx, offset  hcerr 

/error  message  offset  address 

mov 

ah,  9 

/output  function  nr.  for  string 

int 

21h 

/call  DOS-interrupt  21H 

jmp 

short  restore 

; —  all  lines  output 

successfully  - 

mov 

ah, 3Eh 

/close  function  nr.  for  file 

mov 

bx, handle 

/access-key 

int 

21h 

/call  DOS-interrupt  21H 

jc 

error 

/not  closed  — >  Error 

mov  bx, 128  /address  of  number  of  ccxnmand  line 
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mov 

bl,  [bx] 

/number  of  characters  in  command  line 

add 

bl,128 

/calculate  character  end  address 

xor 

bh,bh 

/Hl-Byte  of  the  address  is  0 

inc 

byte  ptr 

[bx] 

/increment  last  number 

cn^ 

byte  ptr 

1 

1 

I 

/reached  ten  ? 

jne 

restore 

/NO  — >  RESTORE 

mov 

byte  ptr 

[bx],-0- 

/set  one  number  back  to  0 

Inc 

byte  ptr 

[bx-1] 

/increment  ten  number 

cmp 

byte  ptr 

[bx-1],-: 

"/has  hundred  been  reached? 

jne 

restore 

/NO  ~>  RESTORE 

mov 

byte  ptr 

[bx-l],-0 

"/ten  numbers  set  back  to  0 

inc 

byte  ptr 

[bx-2] 

/ increment  number 

cmp 

byte  ptr 

[bx-2],-; 

"/has  one  thousand  been  reached? 

jne 

restore 

/NO  ~>  RESTORE 

mov 

byte  ptr 

[bx-2],-0 

"/whole  number  is  again  0 

restore: 

pop 

dx 

/get  old  cursor-position 

mov 

ah,  2 

/and  set  again 

int 

lOh 

/call  BIOS  video-interrupt 

mov 

print, 0 

/hard  copy  output  finished 

pop 

ds 

/restore  all  stored  registers 

pop 

es 

pop 

si 

pop 

di 

pop 

dx 

pop 

CX 

pop 

bx 

pop 

ax 

newhcend: 

Iret 

/back  to  keyboard  routine 

newint 

endp 

—  HCLINE 

—  Input 

—  Output 

—  Register 


Write  a  display  line  into  the  file  - 

BL  -  the  number  of  the  line 

BH  «  the  number  of  the  display  page 

Carry-flag  »  1  :  Error 

AX,  CX,  DX,  SI,  DI  and  FLAGS  are  changed 


hcline 

proc 

near 

push  bx 

xor 

di,di 

xor 

dl,dl 

mov 

si,  80 

getc: 

mov 

ah,  2 

mov 

dh,  bl 

int 

lOh 

mov 

ah,  8 

int 

lOh 

stosb 

inc 

dl 

dec 

si 

jne 

getc 

mov 

ah, 40h 

mov 

bx, handle 

mov 

CX,  80 

xor 

dx,  dx 

int 

21h 

pop 

bx 

ret 

hcline 

endp 

ins tend 

equ  this  t^e 

; store  BX  on  the  stack 

;copy  at  start  of  PSP 
; start  with  column  0 
/process  80  coliunns 

;set  function  number  for  cursor 

/display  line  to  DH 

/call  BIOS  video- interrupt 

/read  function  number  for  character 

/call  BIOS  video- interrupt 

/store  character  in  the  buffer 

/increment  column 

/all  column  processed? 

/NO  — >  get  next  character 

/function  nr.  for  writing 
/access  key 

/every  line  has  80  bytes 
/offset  address  of  the  buffer  is  0 
/call  DOS-lnterrupt  21H 

/restore  BX 
/back  to  caller 


/if  HC2FILE  is  installed,  the  memory 
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;can  be  released  starting  here 
Data  (can  be  overwritten  by  DOS) 

installm  db  13, 10, "HC2FILE  (c)  1987  by  Michael  Tischer",13,10,10 
db  ''HC2FILE  was  installed  and  can  be  ",13,10 
db  "deactivated  with  a  new  call  (without  parameter)  ",13,10 
db  "A  new  call  with  parameters  changes  the  ",13,10 
db  "Name  of  the  file  to  which  hardcopy  is  output. ",13,10,"$" 
deactmsg  db  "HC2FIIiE  was  deactivated",  13, 10,  "$" 
ninstall  db  "HC2FILE  was  not  yet  installed", 13, 10, "$" 
newnam  db  "HC2FILE  was  already  Installed,  only  filename  " 

db  "was  changed", 13, 10,"$" 

Program  (can  be  overwritten  by  DOS) 

; —  Start  and  Initialization-Routine  - 


hcinlt  proc  near 


roov 

si, 128 

/address  of  the  command  line  in  PSP 

onp 

byte  ptr  [si  1,0 

;was  parameter  passed 

mov 

ax,3505h 

;get  content  of  interrupt  vector  5 

Int 

21h 

/call  DOS- function  (flags  remain) 

jne 

install 

/NO  — >  Install  program 

HC2FIIiE  deactivate  again - 

onp 

word  ptr  es:[bx+21. 

"LR"  /test  if  HC2FILE 

je 

away 

/YES  — >  remove  again 

mov 

dx, offset  ninstall 

/was  not  yet  installed 

mov 

al,l 

/end-code:  error 

jmp 

short  hcfendl 

/terminate  program 

away: 

mov 

dx,es:intaltofs 

/offset  address  of  interrupt  5 

mov 

ax,es:lntaltseg 

/segment  address  of  interrupt  5 

roov 

ds,ax 

/to  DS 

mov 

ax, 2505h 

/set  content  of  the  interrupt 

int 

21h 

/vector  5  to  old  routine  again 

mov 

ah,49h 

/release  the  memory  of  old 

int 

21h 

/HC2FILE  again 

push  cs 

/store  CS  on  the  stack 

pop 

ds 

/restore  DS 

mov 

dx, offset  deactmsg 

/message:  program  removed 

hcfend: 

xor 

al,  al 

/end-code:  everything  o.k. 

hcf endl : 

mov 

ah,  9 

/output  function  number  for  string 

int 

21h 

/call  DOS-f unction 

mov 

ah, 4Ch 

/function  nr.  for  prg. termination 

int 

21h 

/end  program  with  end-code 

9 

XlidUtfXX  Xij£« 

install: 

crop 

word  ptr  es: [bx+2] , 

,"LR"  /test  if  HC2FILE 

jne 

newinst 

/NO  — >  first  installation 

was  already  Installed,  change  only  filename  - 

mov 

cl, [si] 

/number  of  characters  in  ccxnmand  line 

inc 

cl 

/also  the  number  of  characters 

xor 

ch,  ch 

/erase  HI-Byte 

mov 

di,128 

/also  ES:DI,  but  in  old  HC2FILE 

cld 

/on  string  commands  count  up 

rep 

movsb 

/copy  filename  in  PSP 

/of  the  old  HC2FILE 

xor 

al,al 

/NUL  terminates  the  filename 

stosb  ; store  in  PSP  of  the  old  HC2FILE 

mov  dx, offset  newnam  ;offset  address  of  the  message 
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jmp 

short  hcfend 

/terminate  program 

newlnst : 

mov 

mov 

lntaltseg,es 

lntaltofs,hx 

/store  segment  and  offset 
/address  of  Interrupt  vector  OSH 

mov 

add 

xor 

mov 

bl, [slj 
bl,129 
bh,bh 

byte  ptr  [bx],0 

/number  of  characters  in  command  line 
/calculate  end  addr.  of  character 
/Hi-Byte  of  the  address  is  0 
/set  NUL  behind  the  file  name 

mov 

mov 

Int 

dx, offset  newlnt 
ax, 2505h 

21h 

/offset  address  new  interrupt -routine 
/deflect  content  of  the  interrupt 
/vector  5  to  user  routine 

mov 

mov 

int 

dx, offset  Installm 
ah,  9 

21h 

/message:  program  installed 
/output  function  number  for  string 
/call  DOS-f unction 

only  the  PSP,  the  new  Interrupt -routine  and  the  - 

Data  pertaining  to  it  must  ranain  resident. 

mov 

mov 

shr 

Inc 

mov 

int 

dx, offset  Instend 
cl,  4 
dx,  cl 
dx 

ax, 3100h 

21h 

/calculate  number  of  paragraphs 
/ (each  16  Bytes)  available  to 
/the  Program 

/end  program  with  end-code  0  (o.k) 

/but  remain  resident 

hclnlt 

endp 

t  *  £«nQ  * 

code 

ends 

end  start 

/End  of  the  CODE-segment 
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FDISK  is  the  hard  disk  partitioning  program  available  in  MS-DOS.  You  probably 
used  the  FDISK  command  if  you  installed  your  own  hard  drive,  or  if  you've 
enhanced  a  PC  with  an  operating  system  such  as  XENIX,  CP/M-86  or  OS/2. 
FDISK  is  the  key  to  operating  high  capacity  hard  disks  and  to  installing  multiple 
operating  systems  on  one  computer. 

FDISK  represents  only  one  step  of  a  three  step  formatting  process.  This  process 
formats  and  partitions  a  hard  disk  drive,  preparing  it  for  one  or  more  operating 
systems. 

Low  level  formatting 

The  first  step,  called  low  level  formatting,  divides  the  hard  disk  into  cylinders 
(tracks)  and  sectors.  This  division  writes  corresponding  address  markm  on  the  hard 
disk.  Low  level  formatting  is  required,  since  many  hard  disk  units  come  from  the 
manufacture  unformatted,  like  flq)py  disks. 

Some  XT-compatible  PCs  had  to  be  low  level  formatted  using  the  DEBUG 
program.  DEBUG  called  the  low  level  format  routine  from  the  hard  disk 
controller's  ROM-BIOS.  Most  hard  disk  manufacturers  now  provide  programs 
which  make  the  low  level  formatting  process  much  simple. 

Partitioning 

The  next  stq)  in  formatting  the  hard  disk  is  partitioning.  As  the  name  suggests, 
this  process  divides  the  hard  disk  into  definite  regions.  The  original  purpose  of 
partitioning  was  to  divide  hard  disks  into  areas  which  could  be  occupied  by 
different  operating  systems,  without  the  operating  systems  conflicting  with  one 
another. 

The  drop  in  hardware  prices  in  the  late  1980s  provided  another  reason  for 
partitioning.  Hard  disks  became  available  at  low  prices  with  capacities  of  40 
megabytes  and  more. 
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This  posed  a  problem.  Versions  of  DOS  below  Version  3.3  could  only  supprst  a 
maximum  of  32  megabytes  per  hard  disk.  In  addition,  earlier  versions  of  DOS 
couldn't  partition  hard  disks  into  several  units. 

DOS  version  3.3 

Version  3.3  of  DOS  still  limited  hard  disk  access  to  a  maximum  of  32  megabytes, 
but  offered  some  alternatives  to  the  user.  DOS  3.3  allowed  the  configuration  of  a 
primary  partition  in  the  first  32  megabytes  of  the  hard  disk,  as  well  as  23 
additional  extmded  parddons  using  drive  specifiers  of  D  to  Z.  Since  every  extended 
parddon  can  have  up  to  32  megabytes,  this  parddoning  increased  the  maximum 
hard  disk  c^tacity  to  768  megabytes.  FDISK  names  these  parddons  PRI  DOS  and 
EXT  DOS. 

DOS  version  4.0 

DOS  version  4.0  permits  mass  storage  device  suiqxnt  ig)  to  2  gigabytes,  thanks  to 
revised  device  drivers.  Howeva,  many  users  still  prefer  parddoning  their  hard  disk 
unit  into  logical  hard  disks  (smallo*  drives),  since  file  management  is  easio*  on  the 
logical  drives  than  having  hundreds  of  files  on  one  drive. 

FDISK  creates  a  special  sector  called  the  parddon  sector  which  it  places  on  the 
first  hard  disk  sector  (head  0,  cylinder  0,  sector  1).  BIOS  loads  this  parddon  sector 
into  memory  address  0000:7C00,  unless  the  user  has  placed  a  disk  in  drive  A: 
befine  pow»-up  or  reset  If  the  computo'  finds  the  code  sequence  SSH,  AAH  in  the 
last  two  bytes  of  this  S12'byte  sector,  it  treats  this  sector  as  executable  and  starts 
program  execudon  with  the  first  byte  of  the  sector.  Otherwise,  BIOS  displays  an 
error  message  and  eitha  starts  an  infinite  loop  or  starts  ROM  BASIC,  dqrending 
on  the  manufacturer  and  vmion  of  the  system. 


iHard  disk  partition  sector  layout  I 

Addr . 

Content 

Type 

+000H 

Partition  code 

+1BEH 

1st  entry  in  the  partition  table 

16  bytes 

+1CEH 

2nd  entry  in  the  partition  table 

16  bytes 

+  1DEH 

3rd  entry  in  the  partition  table 

16  bytes 

+1EEH 

4th  entry  in  the  partition  table 

16  bytes 

+1FEH 

Partition  sector  recognition  code  (AA55H) 

2  bytes 

1  Length:  200H  (512)  bytes  I 

The  program  code  in  the  boot  sector  recognizes  the  acdve  parddon  and  the 
operadng  system  to  be  started.  The  boot  sector  and  the  required  operadng  system 
code  loads  and  executes.  Since  this  program  code  by  definidon  must  also  be  at 
memory  address  0000:7C00,  the  partition  code  moves  to  memory  address 
0000:0600  and  releases  the  memory  for  the  boot  sectra*. 
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The  routine  obtains  the  location  of  the  boot  sector  to  be  loaded  from  the  hard  disk, 
and  the  boot  sector's  corresponding  partition.  The  partition  table  located  in  the 
partition  sector  at  address  IBEH  contains  this  infmnation. 


1  Partition  table  entry  layout  1 

Content 

+00H 

Partition  status 

OOH  =  inactive 

80H  =  boot  partition 

1  byte 

+01H 

Read/write  head  where  partition  starts 

+02H 

Sector  and  cylinder  where  partition  starts 

1  word 

+04H 

Partition  type 

OOH  =  entry  not  occupied 

OlH  =  DOS  with  12-bit  FAT  (primary  partition) 
02H  =  XENIX 

03H  =  XENIX 

04H  =  DOS  with  16-bit  FAT  (primary  partition) 
OSH  =  extended  DOS-Partition  (after  DOS  3.3) 

06H  =  DOS-4. 0  partition  with  more  than  32  meg 
DBH  =  Concurrent  DOS 

Other  codes  possible  in  conjunction  with  other 
operating  systems  or  special  driver  software 

1  byte 

+05H 

Read/write  head  at  end  of  partition 

1  byte 

+06H 

Sector  and  cylinder  at  end  of  partition 

1  word 

+08H 

Distance  of  first  sector  of  the  partition 
(boot  sector)  from  partition  sector 
(measured  in  sectors) 

1  dword 

+0CH 

Number  of  sectors  in  this  partition 

1  dword 

[Length;  lOH  (16)  bytes  I 

Every  partition  is  described  within  this  table  through  a  16-byte  structure.  Since  the 
table  is  almost  at  the  end  of  the  partition  sector,  there  is  only  room  available  for 
four  entries.  This  limits  the  number  of  partitions  to  four.  To  provide  more 
partitions  on  a  hard  disk,  some  manufacturers  offer  a  special  configuration  program 
which  moves  the  table  ahead  within  the  partition  sector  and  installs  new  partition 
code  which  accesses  the  reconfigured  table.  The  basic  format  of  the  table  remains 
unchanged.  Remember  that  individual  partition  entries  do  not  always  start  with  the 
Hrst  table  entry.  The  partition  of  a  hard  disk  can  be  described  through  the  first, 
second,  third  or  even  fourth  table  entry. 

The  boot  partition  can  be  recognized  through  the  first  field  of  the  partition 
structure.  The  value  OOH  stands  for  "inactive,"  while  the  value  80H  indicates  the 
partition  for  booting.  If  the  partition  code  detects  no  bootable  partition,  more  than 
one  partition,  or  even  unknown  code  during  the  table  check,  the  booting  process 
terminates  and  the  system  goes  into  an  endless  loop.  The  only  alternative  is  to 
reset  the  system. 

If  the  partition  code  recognizes  the  partition  to  be  booted,  it  can  determine  the 
position  of  this  partition  on  the  hard  disk  through  the  two  following  bits.  The 
sector  and  cylinder  number  are  coded  in  the  form  compatible  with  BIOS  interrupt 
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13H  (disk/haid  disk).  Bits  6  and  7  of  the  sectw  number  rqnesent  bits  8  and  9  of 
the  cylinder  number.  Interrupt  13H  and  its  functions  are  the  only  means  of 
accessing  the  hard  drive.  DOS  fimctions  are  unavailable  until  after  the  system 
boots  DOS. 

Even  though  this  information  is  enough  to  load  the  boot  sector  of  the  starting 
partition,  the  partition  table  contains  some  additional  information  which  is 
impcMtant  for  later  changes  and  additions.  The  position  of  the  boot  sectw  is 
followed  by  a  field  which  describes  the  type  of  opoating  system  hidden  bdiind  the 
partition. 

Besides  4te  starting  secun*,  the  ending  sector  of  the  partition  is  indicated  in  the 
partition  sector.  The  position  of  this  sectm’  is  again  desoibed  through  an  indicatkm 
of  the  head,  cylinder  and  sector  numbers.  The  last  two  fields  of  a  table  entry 
contain  the  number  of  sectors  within  the  partition,  the  distance  of  the  boot  sector 
of  the  partition  from  the  partition  sector,  as  counted  in  sectors. 

When  the  partition  table  is  checked,  it  usually  determines  that  the  first  partition 
starts  with  sector  one,  track  zero  of  the  second  readAvnte  head,  instead  of 
immediately  following  the  partition  sector.  This  wastes  almost  all  of  track  one  of 
the  Erst  lead/write  head,  almost  the  complete  first  track  of  the  first  head  is  wasted, 
not  counting  the  partition  sector  in  the  first  sector  of  this  track. 

The  extended  DOS  partitions  suffer  from  some  inconsistencies.  First  of  all,  DOS 
Version  3.3  allows  only  one  extended  partition  on  a  hard  disk,  other  than  the 
primary  partition.  FDISK  provides  the  extended  partition  with  a  partition  sector 
containing  a  partition  table  instead  of  program  code.  This  table  consists  of  two 
entries: 


1. )  A  description  of  the  extended  partition  iMX>per,  alrnig  with  a  partition  type 

value  of  either  1  (DOS  partition  with  12-bit  FAT)  or  4  (DOS  partition 
with  16-bit  FAT) 

2. )  A  description  of  the  next  extended  DOS  partition,  if  one  is  present 

Any  additional  extended  partitions  are  preceded  by  partition  sectors,  as  described 
above.  This  creates  a  chained  list  which  ends  only  when  the  partition  type  field 
within  the  partition  sector  contains  the  value  0. 

The  following  programs  in  Pascal  and  C  display  the  contents  of  the  partition 
sector,  and  follow  the  partition  sectors  of  any  extended  partitions. 
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Pascal  program:  FIXPARTP.PAS 


Task 


Author 
Developed  on 
Last  update 


M 

FIXPARTP.PAS  *) 

:  Display  hard  disk  partitioning 
:  MICHAEL  TISCHER 

:  04/26/1989  *) 

:  06/22/1989 

- 

} 


i* 

{* 

{* 

- 

{*  Call  :  FIXPARTP  [  Drive  number  ] 

Default  is  drive  0  (drive  C:) 

^  ★★★★★★★  ^HHH^****  ★★★★★★★★★★★★★★★★★★★★★★ 


uses  Dos;  (  Add  DOS  unit  } 


type  SecPos  «  record  {  Describes  the  position  of  a  sector  } 

Head  :  byte;  {  Read/write  head  } 

SecCyl  :  word;  {  Sector  and  cylinder  number  } 

end; 


PartEntry  =  record 

Status  :  byte; 
Start Sec  :  SecPos; 
PartTyp  :  byte; 
EndSec  :  SecPos; 
SecOfs  :  longint; 
SecNum  :  longint; 
end; 


Entry  in  the  partition  table  } 
{  Partition  status  } 
{  First  sector  } 
{  Partition  type  } 
{  Last  sector  } 
{  Offset  of  the  boot  sector  } 
{  Number  of  sectors  } 


PartSec  *  record  {  Describes  the  partition  sector  } 

BootCode  :  array  [0..$1BD]  of  byte; 

Part Table  :  array  [1..4]  of  PartEntry; 

IdCode  :  word;  {  $AA55  } 

end; 


{*  ReadPartSec  :  Read  a  partition  sector  frcxn  the  hard  disk  and 
{*  place  in  a  buffer 

{** - 

[*  Input  :  -  HrdDrive  :  BIOS  code  of  the  drive  ($80,  $81  etc.)  *} 

-  Head  :  Read/write  head  number 

{*  -  SecCyl  :  Sector  and  cylinder  number  in  BIOS  format 

-  Buf  ;  Buffer  into  which  sector  should  be  loaded 


function  ReadPartSec  (  HrdDrive,  Head  :  byte; 


SecCyl 
var  Buf 

var  Regs  :  Registers; 
begin 

Regs. AX  $0201; 

Regs.DL  :=  HrdDrive; 

Regs.DH  :=  Head; 

Regs.CX  :»  SecCyl; 

Regs.ES  :=  seg(  Buf  ); 

Regs.BX  ofs(  Buf  ); 

Intr(  $13,  Regs); 

ReadPartSec  :*  (  Regs. Flags  and  1 
end; 


:  word; 

;  PartSec  )  :  boolean; 

Processor  regs  for  interrupt  call  } 


Function  no.  for  '•Read'*,  1  sector  } 

{  Load  additional  } 

{  parameters  into  the  } 

{  different  registers  } 


{  Call  hard  disk  interrupt  } 
)  =0;  (Carry  flag  indicates  error} 


^ *************************************************************** ★★★★★★^^  j 

GetSecCyl:  Determines  the  combined  sector/ cylinder  coding  of  BIOS 


{*  sector  and  cylinder  number  *} 

_ j 

{*  Input  :  SecCyl  :  Value  to  be  decoded  *} 
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{*  Sector  :  Reference  to  the  sector  variable 

{*  Cylinder  :  Reference  to  the  cylinder  variable  *) 

^ **★**★★**★ ************************************** *************** *★*★★** j 

procedure  GetSecCyl (  SecCyl  :  word;  var  Sector,  Cylinder  ;  integer  ) ; 
begin 

Sector  :=  SecCyl  and  63;  {  Exclude  bits  6  and  7  } 

Cylinder  :=  hi(  SecCyl  >  +  (  lo(  SecCyl)  and  192  )  shl  2; 
end; 


*  ShowPartition:  Displays  hard  disk  partitioning  on  the  screen  *} 

** _ **} 

*  Input  :  DR  :  Number  of  the  corresponding  hard  disk  drive  *) 

*  (0,  1,  2  etc.)  *) 


** ********★★★*********★*★ ★**★★*★★*****★★*★★****************★********★★} 


procedure  ShowPartition (  DR  :  byte  ); 


var  Head 
SecCyl 
ParSec 
Entry 
Sector, 


Regs 


byte; 
byte; 
Part Sec; 
byte; 


Cylinder  :  integer; 


:  Registers; 


{  Head  of  current  partition  } 
{  Sector  and  cylinder  of  current  partition  ) 
{  Current  partition  sector  } 
{  Loop  counter  ) 
{  Get  sector  and  } 
{  cylinder  numbers  } 
{  Processor  regs  for  interrupt  call  } 


begin 
writeln; 

DR  DR  +  $80; 
if  ReadPartSec(  DR,  0,  1,  ParSec  )  then 
begin 

Regs. AH  :=  8; 

Regs.DL  :*  DR; 

Intr(  $13,  Regs); 


{  Prepare  drive  number  for  BIOS  } 
{  Read  partition  sector  } 
{  Sector  is  readable  } 
{  Read  drive  data  } 


{  Call  hard  disk  interrupt  } 


GetSecCyl (  Regs.CX,  Sector,  Cylinder  ); 
writeln  ( 'F - 


-1-); 


{  Upper  left  corner  can  be  typed  using  <Alt><201>  } 
{  Top  horiz.  line  can  be  typed  using  <Alt><205>  } 

{  Upper  right  comer  can  be  typed  using  <Alt><187>) 
writelnCI  Drive  ',  DR-$80,  ',  Regs.DH+l:2, 

'  Heads  with  ',  Cylinder: 5,  *  cylinders  and  ', 

Sector:3,  '  sectors  |'); 

{  Vert,  lines  can  be  typed  using  <Alt><186>  } 
writelnCI  Partition  table  in  partition  sector  '  + 

•  I’); 

{  Vert,  lines  can  be  typed  using  <Alt><186>  } 

writeln  ("{—T - - ^T'  + 


-^); 


{  Left  T  can  be  typed  using  <Alt><204>  } 

{  Top  T  can  be  typed  using  <Alt><209>  ) 

{  Right  T  can  be  typed  using  <Alt><185>  } 
writelnCI  |  |  |  Start  1*+ 

•  End  lDis.fr. I  |'); 

{  First  and  last  vert,  lines  can  be  typed  using  <Alt><186>  } 

{  Remaining  vert,  lines  can  be  typed  using  <Alt><179>  } 

writelnC  |#.|Boot|Type  |Head  Cyl.  Sec.|*+ 

' Head  Cyl .  Sec.|Bootsec|Number  | ' )  ; 

{  First  and  last  vert,  lines  can  be  typed  using  <Alt><186>  } 

{  Remaining  vert,  lines  can  be  typed  using  <Alt><179>  } 

writeln ("{ — l - 1 - 1  t '  + 


-^  * ) ; 


{  left  T  can  be  typed  using  <Alt><204>  } 
{  crosses  can  be  typed  using  <Alt><216>  ) 
i  Right  T  can  be  typed  using  <Alt><185>  } 
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for  Entry :“1  to  4  do  {  Execute  table  entries  } 

with  ParSec.PartTable[  Entry  ]  do 
begin 

writeCi  Entry,  *1'); 

{  Type  first  line  using  <Alt><186>,  second  using  <Alt><179>  } 
if  Status  =  $80  then  write  ('YES  ') 

else  write  ('  NO  '); 

write  Cl'); 

{  Type  thin  vert,  line  using  <Alt><179>  } 
case  PartTyp  of  {  Display  partition  type  } 


$00 

;  write ('Not  occupied 

•); 

$01 

;  write ('DOS,  12-blt  FAT 

•); 

$02 

;  write ('XENIX 

•); 

$03 

;  write ('XENIX 

•); 

$04 

;  write ('DOS,  16-blt  FAT 

•); 

$05 

;  write ('DOS,  extd.partltlon') ; 

$DB 

;  write (' Concurrent  DOS 

•); 

else 

write ('Unknown  (*, PartTyp; 3, 

end; 

GetSecCyl (  StartSec.SecCyl,  Sector,  Cylinder  ); 
wrlteCl'f  StartSec.Head:2,  '  ', Cylinder; 5, '  ',Sector:3  ); 
GetSecCyl (  EndSec.SecCyl,  Sector,  Cylinder  ); 

{Enter  vert,  line  using  <Alt><179>  } 
wrlteC  I',  EndSec.Head:2,  •  ', Cylinder; 5, '  ',Sector;3  ); 

(Enter  vert,  line  using  <Alt><179>  } 
wrltelnC  I',  SecOfs;7,  *1' /  SecNum;7, 'I' ) ; 

{  Enter  first  and  second  vert,  lines  using  <Alt><179>,  } 
{  third  line  using  <Alt><186>  } 

end; 

writelncL — ^1 - - 1 - ^1*  + 

. - - ^J'#13#10); 

{  Left  angle  can  be  typed  using  <Alt><200>  } 

{  Horlz.  lines  can  be  types  using  <Alt><205>  } 
{  Bottcam  Ts  can  be  typed  using  <Alt><207>  } 

{  Right  angle  can  be  typed  using  <Alt><188>  } 

end 

else 

writeln ( ' Error  during  boot  sector  access ! ' ) ; 

end; 


^ ***★*★**★*★*★★★*★***★*****★*★****★★★★*★★★★****★★****★********* ********* 
*  MAINPROGRAM  * 

***********************************************************************} 


var  HrdDrlve, 

DError  ;  Integer; 


{  Variables  for  converting  } 
{  given  arguments  } 


begin 

wrlteln(  #13#10' - FIXPARTP  -  (c)‘, 

'  1989  by  MICHAEL  TISCHER - *  ); 

HrdDrlve  ;-  0;  {  Default  is  first  hard  disk  } 

if  PararaCount  «  1  then  {  Other  drive  specifier  given?  } 

begin  {  YES  } 

val(  ParamStr(l),  HrdDrlve,  DError  );  {  ASCII/decimal  } 

if  DError  o  0  then  {  Conversion  error?  } 

begin  {  YES  } 

writeln (#13#10' Illegal  drive  specifier!'); 

exit;  {  End  program  } 

end; 

end; 

ShowPartitlon(  HrdDrlve  );  {  Display  partition  sector  } 

end. 
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C  program:  FIXPARTC.C 

/*★★*★★**★★*★★*★★**★**★**★★*★*★****★★**★***★*★★**★★★★★*★★*★★★**★*★★★**★/ 


/*  FIXPARTC.C  */ 

/* - */ 

/*  Task  :  Displays  hard  disk  partitioning  */ 

/* - ^ - */ 

/*  Author  :  MICHAEL  TISCHER  */ 

/*  Developed  on  :  04/26/1989  */ 

/*  Last  update  :  06/22/1989  */ 

/* - - - */ 

/♦Call  :  FIXPARTC  [  Drlve_number  ]  */ 

/*  Default  is  drive  0  (Drive  C:)  */ 


/**★★*★★*★★**★**★★*★★**★**★★★★*************★★**★★*★★*★*★★★★*★**★★*★★★*★/ 

♦include  <dos.h> 

♦include  <string.h> 

♦include  <stdlib.h> 

♦define  TRUE  (  1  -=  l  ) 

♦define  FALSE  (  1==  0  ) 

♦define  HI (x)  (  * ( (BYTE  *>  (&x)+l)  )  /*  Returns  high  byte  of  a  word  */ 

♦define  LO(x)  (  * ( (BYTE  *>  &x)  )  /*  Returns  low  byte  of  a  word  */ 

/*=“  Type  declarations 

typedef  unsigned  char  BYTE; 
typedef  unsigned  int  WORD; 

typedef  struct  { 

BYTE  Head; 

WORD  SecCyl; 

}  SECPOS; 

typedef  struct  {  /*  Entry  in  the  partition  table  */ 

BYTE  Status;  /*  Partition  status  */ 

SECPOS  StartSec;  /*  First  sector  */ 

BYTE  PartTyp;  /*  Partition  type  */ 

SECPOS  EndSec;  /*  Last  sector  */ 

unsigned  long  SecOfs;  /*  Offset  of  boot  sector  */ 

unsigned  long  SecNum;  /*  Number  of  sectors  */ 

}  PARTENTRY; 

typedef  struct  {  /*  Describes  the  partition  sector  */ 

BYTE  BootCode[  OxlBE  ]; 

PARTENTRY  PartTable[  4  ]; 

WORD  IdCode;  /*  0xAA55  */ 

}  PARTSEC; 

typedef  PARTSEC  far  *PARSPTR;  /*  Pointer  >  partition  sector  in  memory  */ 

/★*★★*★★*★★★*★★** ★★★★**★★**********************************************/ 
/*  ReadPartSec  :  Reads  a  partition  sector  from  the  hard  disk  into  a  */ 


/*  buffer  */ 

/*  Input  :  -  HrdDrive  :  BIOS  code  of  the  drive  (0x80,  0x81  etc.)  */ 

''  /*  -  Head  ;  Number  of  read/ write  heads  */ 

/*  -  SecCyl  :  Sector  and  cyinder  number  in  BIOS  format  */ 

/*  -  Buf  :  Buffer  into  which  sector  should  be  loaded  */ 

/*  Output  :  TRUE  if  sector  is  read  without  error,  otherwise  FALSE  */ 


/ ********************************************************************** / 
BYTE  ReadPartSec (  BYTE  HrdDrive,  BYTE  Head,  WORD  SecCyl,  PARSPTR  Buf  ) 


/*  Describes  the  position  of  a  sector  */ 
/*  Read/write  head  */ 
/*  Sector  and  cylinder  number  */ 
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union  REGS  Regs;  /*  Processor  regs  for  Interrupt  call  */ 

struct  SRE6S  SRegs; 

Regs. X. ax  -  0x0201; 

Regs.h.dl  -  HrdDrive; 

Regs.h.dh  -  Head; 

Regs.x.cx  -  SecCyl; 

Regs.x.bx  -  FP_OFF(  Buf  ); 

SRegs.es  -  FP_SEG(  Buf  ); 

int86x(  0x13,  &Regs,  &Regs,  aSRegs  );  /*  Call  hard  disk  Interrupt  */ 

return  ! Regs. x.cf lag; 

} 

/★*********************************************************************/ 


/*  GetSecCyl:  Determines  the  combined  sector/cylinder  coding  from  */ 
/*  BIOS  sect or/ cylinder  number  */ 
/*  Input  :  SecCyl  :  Value  to  be  decoded  */ 
/*  Sector  :  Reference  to  the  sector  variable  */ 
/*  Cylinder  ;  Reference  to  the  cylinder  variable  */ 
/*  Output;  none  */ 


/****★****★***** *★★****★★*****★************★*****★****★★★*-**** *********/ 
void  GetSecCyl (  WORD  SecCyl,  Int  *Sector,  Int  ^Cylinder  ) 

{ 

♦Sector  “  SecCyl  a  63;  /*  Exclude  bits  6  and  7  ♦/ 

♦Cylinder  -  HI (SecCyl)  +  (  (  (WORD)  LO (SecCyl)  &  192  )  «  2  ) ; 

} 

/****★★★★★★****★*★*★★★★★*********★*********★★★★*★**★★**★★★★★******★*★**/ 
/♦  ShowPartltlon:  Displays  hard  disk  partitioning  on  the  screen  ♦/ 

/♦  Input:  LW  ;  Number  of  the  hard  disk  (0,  1,  2,  etc.)  ♦/ 

/♦  Output:  none  ♦/ 

/★★★★★A ***★★★★★★★★*****★★★★★★★***★*★★*★★★*★****★★★★★★*****★*★★★★** ★★***/ 


/♦  Funct.no.  for  "Read",  1  Sector  ♦/ 
/♦  Load  parameters  Into  ♦/ 
/♦  different  registers  as  ♦/ 
/♦  needed  ♦/ 


void  ShowPartltlon (  BYTE  LW  ) 

{ 

♦define  AP  ParSec. Part Table [  Entry  ] 


BYTE  Head, 

Entry, 
SecCyl ; 
PARTSEC  ParSec; 

Int  Sector, 

Cylinder; 
union  REGS  Regs; 

print f ("\n") ; 

LW  1=  0x80; 

If  (  ReadPartSec(  LW, 

{ 

Regs. h. ah  *  8; 
Regs.h.dl  =  LW; 
lnt86(  0x13,  &Regs, 


/♦  Head  for  current  partition 
/♦  Loop  counter 
/♦  Sector  and  cylinder  of  current  partition 
/♦  Current  partition  sector 
/♦  Get  sector  and  cylinder 
/♦  number 

/♦  Processor  regs  for  Interrupt  call 


/♦  Prepare  drive  number  for  BIOS 
0,  1,  fiParSec  )  )  /♦  Read  partition  sector 

/♦  Sector  can  be  read 
/♦  Read  disk  data 


&Regs  ) ;  /♦  Call  hard  disk  Interrupt 

GetSecCyl (  Regs.x.cx,  &Sector,  ^Cylinder  ); 

prlntf(  "F - " 

" - l\n")  ; 


/♦  Upper  left  corner  can  be  typed  using  <Alt><201> 
/♦  Horizontal  line  can  be  typed  using  <Alt><205> 

/♦  Upper  right  corner  can  be  typed  using  <Alt><187> 
prlntf  (  "I  Drive  %2d:  %2d  heads  with  %4d" 

"  cylinders,  %3d  sectors  |\n", 

LW-0x80,  Regs.h.dh+1,  Cylinder,  Sector  ); 

/*  Vertical  lines  at  beginning  and  end  can  be  typed  using  <Alt><186> 
prlntf  (  "I  Partition  table  In  partition  sector  " 

••  |\n"); 

/♦  Vertical  lines  at  beginning  and  end  can  be  typed  using  <Alt><186> 


♦/ 

*/ 

♦/ 

♦/ 

♦/ 

♦/ 

♦/ 


♦/ 

♦/ 

*/ 

♦/ 

♦/ 


♦/ 

♦/ 


♦/ 


♦/ 
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printf(  -I— T - 


" - - i\n"); 

/*  Left  T  can  be  typed  using  <Alt><199>  */ 

/*  Horiz.  lines  can  be  typed  using  <Alt><205>  */ 

/*  Ts  in  middle  of  line  can  be  typed  using  <Alt><209>  ♦/ 
/*  Right  T  can  be  typed  using  <Alt><185>  */ 

printf(  "III  I  Start  |" 

"  End  pis.fr.l  |\n"); 

/*  First  and  last  vertical  lines  in  the  above  line  */ 

/*  can  be  typed  using  <Alt><186>  ♦/ 

/*  Remaining  vertical  lines  can  be  typed  using  <Alt><179>  */ 
printf(  "li.lBootlTVpe  |Head  Cyl.  Sec.|" 

"Head  Cyl.  Sec.|BootSec|Number  |\n"); 

/*  First  and  last  vertical  lines  in  the  above  line  */ 

/*  can  be  typed  using  <Alt><186>  */ 

/*  Remaining  vertical  lines  can  be  typed  using  <Alt><179>  */ 

print f  (  "*{ — I - 1  I  I-* 

" - 1 - — <\n"); 

/*  Left  T  can  be  typed  using  <Alt><204>  */ 

/*  Horizontal  lines  can  be  typed  using  <Alt><205>  */ 
/*  Crosses  can  be  typed  using  <Alt><215>  */ 

/*  Right  T  can  be  typed  using  <Alt><185>  */ 

/★ —  Check  partition  table  - */ 

for  (  Entry-0;  Entry  <4;  ++Entry  ) 


print f(  "I  %dl".  Entry  ); 

/*  First  vertical  line  can  be  typed  using  <Alt><186>  */ 

/*  Second  vertical  line  can  be  typed  using  <Alt><179>  */ 
if  (  AP. Status  —  0x80  )  /*  Partition  active?  */ 

printf("Yes  "); 
else 

print f  ("No  "); 
printf  ("I"); 


switch (  AP.PartTyp  ) 


/*  Vertical  line  can  be  typed  using  <Alt><179>  */ 


Display  partition  types 


printf  (  "Not  occupied  "  ); 

break; 

printf (  "DOS,  12-Bit  FAT  "  ); 
break; 

printf (  "XENIX  "  ); 

break; 

printf  (  "xpiix  "  ); 

break; 

printf (  "DOS,  16-Bit  FAT  "  ); 
break; 

printf (  "DOS,  extended  part."  ); 
break; 

printf (  "Concurrent  DOS  "  ) ; 

break;’ 

printf (  "Unknown  (%3d) 

ParSec. Part Table [  Entry  J.PartTyp  ); 


/* —  Display  physical  and  logical  parameters  - */ 

GetSecCyl(  AP.StartSec.SecCyl,  ^Sector,  ^Cylinder  ); 

printf  (  "|%2d  %5d  %3d  ",  AP.  St  art  Sec.  Head,  Cylinder,  Sector  ); 

/*  Vertical  line  can  be  typed  using  <Alt><179>  */ 

GetSecCyl  (  AP.EndSec.SecCyl,  &Sector,  ^Cylinder  ); 

printf  (  "|%2d  %5d  %3d  ",  AP.EndSec.Head,  Cylinder,  Sector  ); 

/*  Vertical  line  can  be  typed  using  <Alt><179>  */ 

printf  (  "|%61u  |%61u  |\n",  AP.SecOfs,  AP.SecNura  ); 

} 

/*  First  and  second  vertical  lines  can  be  typed  using  <Alt><179>  */ 
/*  Third  vertical  line  can  be  typed  using  <Alt><186>  */ 

printf  (  -L — - 1 - ^1" 
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- - - ^J\n"  ); 

/*  Left  angle  can  be  typed  using  <Alt><200>  */ 

/*  Horizontal  lines  can  be  typed  using  <Alt><205>  */ 
/*  Ts  can  be  typed  using  <Alt><207>  */ 

/*  Right  angle  can  be  typed  using  <Alt><188>  */ 

} 

else 

printf ("Error  during  boot  sector  access !\n"); 


} 


*  MAINPROGRAM  * 

*****************************★★★★********★*★*★*************************/ 


int  inaln(  Int  argc,  char  *argv[]  ) 

{ 

int  HrdDrlve; 

prlntf(  "\n - FIXPARTC  -  (c) " 

"  1989  by  MICHAEL  TISCHER  - \n"  ); 

HrdDrlve  »  0;  /*  Default  is  first  hard  disk  */ 

if  (  argc  “  2  )  /*  Other  drive  specified?  */ 

{  /*  YES  */ 

HrdDrlve  »  atol  (  argv[l]  ); 
if  (  HrdDrlve  0  &&  ■*argv[l]  !-  'O'  ) 

( 

prlntf ("\nlllegal  drive  specifier!"); 

return (  1  );  /*  End  program  */ 

) 

] 

ShowPartltlon(  HrdDrlve  );  /*  Display  partition  sector  */ 

return (  0  ) ; 

} 
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The  PC  Ports 


Ch^ter  2  of  this  book  described  a  series  of  CPU  support  chips  which  help  the 
CPU  control  the  system.  These  chips  stay  in  constant  contact  with  the  CPU, 
which  delegates  tasks  to  and  obtains  information  from  the  support  chips. 


Ports 


The  ports  represent  the  interfaces  between  the  CPU  and  the  other  system  hardware. 
A  port  can  be  viewed  as  an  8-bit- wide  data  input  or  output  connected  to  a  particular 
piece  of  hardware.  A  port  has  an  assigned  address  with  values  ranging  from  0  to 
65,535.  The  CPU  uses  the  data  bus  and  address  bus  to  communicate  with  the 
ports.  If  the  CPU  needs  access  to  a  port,  it  transmits  a  port  control  signal.  This 
signal  instructs  the  other  hardware  that  the  CPU  wants  to  access  a  port  instead  of 
RAM.  Ports  have  addresses  which  are  also  assigned  to  memory  locations  in  RAM, 
but  these  addresses  have  nothing  to  do  with  those  memory  locations.  The  port 
address  is  placed  on  the  lowest  16  bits  of  the  address  bus.  This  instructs  the  system 
to  transfer  the  eight  bits  of  information  following  on  the  data  bus  to  the  proper 
port.  The  hardware  connected  with  this  port  receives  the  data  and  responds 
accOTdingly. 

The  80(x)xx  processor  series  has  two  instructions  that  control  this  process  from 
within  a  program.  The  IN  instruction  sends  data  from  the  CPU  to  a  port;  the  OUT 
instruction  transfers  data  from  a  port  into  the  CPU. 

The  system  can  set  the  pent  address  of  a  certain  hardware  device — this  address  is  not 
a  constant  value.  For  this  reason,  there  are  many  similarities  in  port  addressing 
between  the  PC,  XT  and  AT.  There  are  few  differences  between  the  PC  and  XT, 
but  many  differences  exist  between  the  PC  and  AT. 
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The  following  table  shows  the  port  addresses  of  individual  chips  in  each  syston. 


Component 

PC/XT 

AT 

DMA  controller  (8237A-5) 

OOO-OOF 

OOO-OIF 

Interrupt  controller  (8259A) 

020-021 

020-03F 

timer 

040-043 

040-05F 

Programmable  Peripheral  Interface  (PPI  8255A-5) 

060-063 

none 

Keyboard  (8042) 

none 

060-06F 

Realtime  clock  (MC146818) 

none 

070-07F 

DMA  page  register 

080-083 

080-09F 

Interrupt  controller  2  (8259A) 

none 

OAO-OBF 

DMA  controller  2  (8237A-5) 

none 

OCO-ODF 

Math  coprocessor 

none 

OFO-OFl 

Math  coprocessor 

none 

0F8-0FF 

Hard  disk  controller 

320-32F 

1F0-1F8 

Game  port 

200-20F 

200-207 

Expansion  unit 

210-217 

none 

Interface  for  second  parallel  printer 

none 

278-27F 

Second  serial  interface 

2F8-2FF 

2F8-2FF 

Prototype  card 

300-31F 

300-31F 

Network  card 

none 

360-36F 

Interface  for  first  parallel  printer 

378-37F 

378-37F 

Monochrome  Display  Adapter  and 
parallel  printer  connection 

B0-3BF 

3B0-3BF 

Color/Graphics  Adapter 

3D0-3DF 

3D0-3DF 

Disk  controller 

3F0-3F7 

3F0-3F7 

First  serial  interface 

3F8-3FF 

3F8-3FF 
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Interaction  between 
Keyboard,  BIOS  and  DOS 


The  preceding  chapters  of  this  book  described  three  levels  of  PC  system 
architecture: 

•  DOS 

•  BIOS 

•  hardware 

We've  examined  each  level  separately  throughout  this  book.  This  chapter 
investigates  the  interaction  between  the  three  levels.  We'll  use  the  keyboard  as  an 
example,  because  it  best  illustrates  the  connection  between  the  three  levels.  We'll 
start  with  the  lowest  level  (the  hardware  itself)  and  progress  to  the  highest  level  (an 
application  program  which  communicates  with  the  uso*  through  the  keyboard). 

Hardware  level 

The  hardware  level  consists  of  the  keyboard  itself,  which  connects  to  the  CPU 
through  a  cable.  This  keyboard  contains  either  an  Intel  8048  (PC/XT)  or  8042 
(AT)  processor.  The  processm-'s  task  monitors  the  keyboard  to  determine  whether  a 
key  was  depressed  or  released.  If  a  user  depresses  a  key  for  longer  than  half  a 
second,  the  8048  enables  key  rqteat  at  a  rate  of  10  charactos  per  second.  While  the 
8048  can  only  repeat  at  this  frequency,  the  8042's  repeat  frequency  can  be  changed 
to  other  values.  This  repetition  continues  until  the  user  releases  the  key.  The 
keyboard  processor  assigns  each  key  a  numb»,  instead  of  a  character  or  ASCII 
code.  It  views  control  keys  such  as  <Shift>  and  <Ctrl>  like  any  other  key.  In  the 
83-key  standard  PC  keyboard,  the  processor  assigns  numbers  to  the  keys  ranging 
from  I  to  83  decimal. 
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BIOS  level 

When  you  press  a  key,  this  key  code  passes  to  the  CPU  as  a  byte.  When  you 
release  the  key  the  processor  passes  the  code  to  the  CPU  again,  along  with  an 
added  128.  This  is  the  same  as  setting  bit  7  in  the  byte.  The  keyboard  instructs  the 
8259  interrupt  controller  that  the  CPU  should  trigger  interrupt  9H.  If  the  CPU 
responds  we  reach  the  next  level,  because  a  BIOS  routine  is  controlled  through 
interrupt  9H.  While  this  routine  is  being  called,  the  keyboard  processor  sends  the 
key  code  to  port  60H  of  the  main  circuit  board  using  the  asynchronous 
transmission  protocol.  The  BIOS  routine  checks  this  port  and  obtains  the  number 
of  the  depressed  ot  released  key.  This  routine  then  generates  an  ASCII  code  from 
this  key  code. 

This  task  is  more  complex  than  frrst  appears,  since  the  BIOS  routine  must  test  for 
a  control  key  such  as  <Shift>  or  <Alt>.  Depending  on  the  key  or  combination  of 
keys,  either  a  normal  ASCII  code  or  an  extended  keyboard  code  may  be  required. 
The  extended  key  codes  include  any  keys  which  don't  necessarily  input  characters 
(e.g.,  cursor  keys). 

Once  BIOS  determines  the  correct  code,  this  code  passes  to  the  16-byte  BIOS 
keyboard  buffer.  If  it  is  full,  the  routine  produces  a  beep  which  informs  the  user  of 
an  overflow  in  the  keyboard  buffer.  The  processor  returns  to  the  other  tasks  which 
were  in  progress  before  the  call  to  interrupt  9. 

The  next  level,  BIOS  interrupt  16H,  reads  the  character  in  the  keyboard  buffer  and 
makes  it  available  to  a  program.  This  interrupt  includes  three  BIOS  routines  for 
reading  characters  from  the  keyboard  buffer,  as  well  as  the  keyboard  status  (e.g., 
which  control  keys  were  pressed).  These  three  routines  can  be  called  with  an  INT 
assembly  language  instruction  from  an  application  program. 

DOS  level 

The  keyboard's  device  driver  routines  represent  the  DOS  level.  These  DOS  routines 
read  a  character  from  the  keyboard  and  store  the  character  in  a  buffer,  using  the 
BIOS  functions  from  interrupt  16H.  In  some  cases,  the  DOS  routines  may  clear 
the  BIOS  keyboard  buffer.  If  the  system  uses  the  extended  keyboard  driver 
ANSI.SYS,  ANSI.SYS  can  translate  certain  codes  (e.g.,  function  key  1)  into  other 
codes  or  strings.  For  example,  it's  possible  to  program  the  <FI0>  key  to  display 
the  DER  command  on  the  screen.  You  can  theoretically  call  device  driver  functions 
from  within  an  application  program,  but  in  practice  DOS  functions  usually  address 
these  functions. 

DOS  is  the  highest  level  you  can  go.  Here  you'll  find  the  keyboard  access 
functions  in  DOS  interrupt  21H.  These  functions  call  the  driver  functions, 
transmit  the  results  and  perform  many  other  tasks.  For  example,  characters  and 
strings  can  be  read  and  displayed  directly  on  the  screen  until  the  user  presses  the 
<Retum>  key.  These  strings  are  called  by  an  jq)plication  program  and  form  the  end 
of  this  chain  of  events. 
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Levels  of  keyboard  access 
The  keyboard  access  levels  are  as  follows: 

(1)  Enables  functions  available  for  keyboard  access 

(2)  Reads  a  character  with  the  functions  of  interrupt  16H  and  converts  it  into 
otho’  charact^  or  charact^  strings  as  needed 

(3)  Reads  keyboard  status  or  a  character  fixxn  the  keyboard  buffin’  and  transfers 
it  to  the  calling  program 

(4)  Accepts  the  charactn’ento’ed 

(5)  Receives  codes  from  the  keyboard,  convnts  them  into  ASCII  or  extended 
keyboard  codes  and  adds  them  to  the  keyboard  buffer 

(6)  Calls  interrupt  9  when  the  key  is  depressed  or  released 

When  you  consider  the  many  levels  through  which  a  key  code  has  to  travel  before 
reaching  an  implication  program,  you  mig^t  be  thinking  that  direct  keyboard  access 
would  be  much  faster.  In  principle  that's  true,  but  the  process  as  described  above 
offers  several  advantages.  One  advantage  is  that  the  system  offers  complex 
functions  which  reduce  progranuning  work,  such  as  simultaneously  displaying  a 
line  on  the  screen  as  you  enter  it  from  the  keyboard.  Also,  using  higher  level 
functions  make  programs  hardware  independent,  so  that  they'll  run  on  PCs  that 
may  not  be  hardware-compatible  with  the  IBM  PC  but  still  use  DOS  as  the 
operating  system. 
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The  program  which  omcludes  this  clug)ter  derntnistrates  a  method  of  changing  the 
system  levels.  The  challenge  is  to  inoease  the  size  of  the  BIOS  keyboard  buffo'. 
The  keyboard  buffer  usually  holds  up  to  16  characters  before  emitting  beeps  to  tell 
the  uso  that  the  buffer  is  full. 

The  assemblo  program  which  follows  increases  the  size  of  the  keyboard  buffer  to 
128  charactos  (256  bytes).  It  genoates  extended  intorupt  handlers  for  hardware 
keyboard  intorupt  09H  and  BIOS  keyboard  interrupt  16H. 


•  ****** ****** ************************************************** ********* 


•  * 

■  * _ 

K  E  Y  B  U  F 

.  * 

/ 

Task 

:  Installs  extended  keyboard  reading  interrupt 

t 

* . 
r 

•  * 
r 

routines  and  implements  a  virtual  keyboard 

*  • 

■  * 

buffer  of  up  to  256  l:^es  (128  characters) . 

it  • 

9 

•  ^ 

/ 

An  initial  call  Installs  the  program,  while  a 

* « 

;* 

second  call  disables  the  program. 

★  • 
9 

•  * 

Author 

:  MICHAEL  TISCHER 

9 

it  • 

•  * 

Developed  on 

:  08/24/1988 

★  • 

.  * 

.  * _ 

Last  update 

:  06/23/1989 

9 

>^it  • 

•  * 
r 

Assembly 

:  MASM  KEYBDF/ 

■  * 

LINK  KEYBUF/ 

*  • 
9 

•  * 

•  *— _ 

EXE2BIN  KEYBUF  KEYBUF.COM 

it  • 

— ★  • 

Call 

:  KEYBUF 

9 

★  - 

•  ■k* -k *** -k-k -k -k-k -k-k-k-tt -k-k -k -k-k -k it -k *1fk -k -k -k -kh-k -k-k-klt  *********** -k-khifkifkltlfk -kit -kit ******* -kit  • 

bios  segment  at  4 Oh  /Segment  begins  at  0040:0000 

org  lah 

; —  BIOS  pointer  points  to  the  keyboard  ring  buffer  - 

b_next  dw  (?)  /Pointer  to  next  character 

b_last  dw  (?)  /Pointer  to  last  character 

bios  ends 

/“  Constants 

KB_LEN  equ  128  /Keyboard  buffer  length  must  be  a 

/power  of  2  (change  this  constant  to 
/change  the  size  of  the  keyboard  buffer 
/e.g.,  2,  4,  8,  16,  32,  etc.) 


/»»  Start  of  program 

code  segment  para  'CODE'  /Definition  of  CODE  segment 

org  lOOh 

assume  cs/code,  ds/code,  esicode,  ssicode 
start:  jmp  kb_ini  /First  executable  instruction 

/“  Data  (stays  in  memory) 

keybuf_id  dw  "CS"  /Identifies  the  program 

env_seg  dw  (?) 
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equ  this  dword 


/Segment  address  of  environment 
/Old  interrupt  vector  09H 
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lnt9_ofs  dw  (?) 
int9_seg  dw  (?) 

inti 6  equ  this  dword 

intl6__ofs  dw  (?) 
intl6_seg  dw  (?) 


/Offset  address  interrupt  vector  09H 
/Segment  address  interrupt  vector  09H 

/Old  interrupt  vector  16H 

/Offset  address  interrupt  vector  16H 

/Segment  address  interrupt  vector  16H 


/—  Virtual  )ceyboard  buffer  is  placed  in  the  PSP  of  this  program, 
/ —  making  the  program  resident  until  a  second  call  disables  it 


next  key  dw  0 

curkey  dw  KB_LEN  -  2 

/—  New  interrupt  hander 

new_lnt  9  proc  far 

assume  dsrblos 

pushf 

call  cs:int9 


/Offset  address  of  next  key 
/Offset  address  of  current  key 


/New  INT  9H  handler 

/Assign  DS  the  BIOS  variable  segment 

/Simulate  interrupt  call  to  old  INT 
/9H  handler 


ni9  0: 


ni9  1: 


ni9  end: 


new  int9 


/ —  Get  character  from  BIOS  keyboard  buffer  - 


/Push  all  registers  which  will  be 
/changed  by  this  new  interrupt 
/handler  onto  the  stack 


/Get  segment  address  of  BIOS  variable 
/segment  to  DS 

/Move  DI  to  next  character  in  KEYBUF 
/BIOS:  Get  address  of  next  character 

/Still  a  character  in  BIOS  kbd  buffer? 
/No  more  characters  — >  END 


/Get  character  frcwi  BIOS  kbd.  buffer 
/Set  pointer  to  next  character 
/Reached  end  of  keyboard  buffer? 

/NO  — >  NI9_1 

/YES  — >  Set  start  of  kbd.  buffer 

/Virtual  keyboard  buffer  full  yet? 
/YES  — >  Don't  store  any  more  chars 
/Characters  in  virtual  kbd.  buffer 
/Set  pointer  to  next  character 
/Wrap-around 
/Get  next  character 

/Mark  position  for  next  character 
/Set  BIOS  pointer  to  next  character 
/Pop  registers  off  of  stack 


/Return  to  interrupt  caller 
/DS  indicates  code  segment 


cli 

push 

es 

push 

ds 

push 

di 

push 

bx 

push 

ax 

mov 

ax, bios 

mov 

ds,ax 

mov 

di, cs: next key 

mov 

bx,  b_next 

cmp 

bx,  b_last 

je 

ni9_end 

/ —  Still  a  charact 

mov 

ax, [bx] 

add 

bx,2 

cmp 

bx, 3eh 

jne 

ni9_l 

mov 

bx, leh 

cmp 

di, cs: curkey 

je 

ni9_0 

mov 

cs: [di] ,ax 

add 

di,2 

and 

di,KB  LEN-1 

jmp 

ni9  0 

mov  cs: next key, di 

mov  b_next,bx 

pop  ax 

pop  bx 

pop  di 

pop  ds 

pop  es 

iret 

assume  ds:code 
endp 


New  handler  for  BIOS  keyboard  interrupt  16H  - 
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new_lntl6  proc  far 


;New  Interrupt  16H  handler 


stl 

cnp  ah,  1 
ja  status 


/Enable  interrupt 
/Read  keyboard  status? 
/YES  — >  Status 


/ —  Update  keyboard  LEDs  when  function  1  of  the  old  keyboard 
/ —  handler  is  called 


nll6  0: 


push 

ax 

/Push  function  code  on 

the  stack 

pushf 

/Push  flags  onto  stack 

mov 

ah,l 

/ Funct.no.:  Key  ready? 

call 

cs: [intl6] 

/Call  old  handler 

pop 

ax 

/Pop  function  code  off 

of  stack 

push 

bx 

/Push  BX  onto  stack 

mov 

bx,  cs: curkey 

/Get  pointer  to  current  key 

add 

bx,2 

/Set  to  next  word 

and 

bx, KB_LEN-1 

/Wrap-around 

or 

ah,  ah 

/Read  character? 

je 

nll6_2 

/YES  — >  Get  character 

from  buffer 

/ —  Function  1:  Help  caller  determine  whether  a  character  is  - 
/ —  available 


nll6  1: 


nll6  2: 


amp  bx, cs : next key 
je  nil6_l 

mov  ax, cs:[bx] 
pop  bx 
ret  2 


/Found  a  character  in  KEYBUF? 

/NO  — >  NI16_1 

/YES,  Get  character  from  KEYBUF 
/Pop  BX  off  of  stack 
/Return  to  caller  but  DO  NOT  remove 
/flags  from  stack 


/ —  Function  0:  Read  character  fron  the  keyboard  buffer  - 


amp  bx,  cs :  next  key 
je  nll6_0 

mov  ax, cs:[bx] 
mov  cs : curkey , bx 
pop  bx 
Iret 

status:  jmp  cs: [intl6] 

new_intl6  endp 


/Character  found  in  KEYBUF? 

/NO  — >  NI16_0 

/YES  —  >  Get  character  fran  KEYBUF 
/Store  position  for  current  character 
/Pop  BX  off  of  stack 
/Return  to  caller 

/Jump  to  old  handler 


instend  equ  this  byte  /Everything  must  remain  resident  up 

/to  this  memory  location 

/“  Data  (cann  be  overwritten  from  DOS) 

Installm  db  13,10," - KEYBUF  (c)  1988  by  Michael  Tlscher - ",13,10,13,10 

db  "KEYBUF  now  enabled.  Entering  KEYBUF  a  second  time", 13, 10 
db  "from  the  DOS  pronpt  disables  the  KEYBUF  program. ",  13, 10, "$" 

removeit  db  13,10," -  KEYBUF  <c)  1988  Michael  Tischer  - ",13,10 

db  "KEYBUF  program  now  disabled.", 13, 10, "$" 

/“  Program  (can  be  overwritten  from  DOS) 

/ —  Start  and  nitialization  routine - 

kb_lnl  label  near 

mov  ax,3509h  /Get  contents  of  interrupt  vector  9H 
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install 


int 

21h 

;Cal  DOS  function 

cmp 

es:keybuf  id, "CS" 

/Program  already  installed? 

jne 

install 

;NO  — >  Install 

If  KEYBUF  is  already  installed,  remove  it  - 

cli 

/Disable  Interrupts 

Ids 

dx,es:int9 

/DS:DS  -  old  handler  address  int9H 

mov 

ax,2509h 

/Return  Interrupt  vector  for  int  9H 

int 

21h 

/to  old  interrupt  handler 

Ids 

dx,es:intl6 

/DS:DS  «  Old  handler  address  intl6H 

mov 

ax,2516h 

/Return  interrupt  vector  16H  to  old 

int 

21h 

/interrupt  handler 

sti 

/Enable  interrupt 

mov 

bx,es 

/Move  segment  address  of  program 

mov 

es,es:env  seg 

/Get  segment  address  of  environment 

mov 

ah,  49h 

/from  code  segment  and 

int 

21h 

/release  memory 

mov 

es,bx 

/Release  memory  of 

mov 

ah,49h 

/old  KEYBUF  using 

int 

21h 

/DOS  interrupt  49H 

push  cs 

/Push  CS  onto  stack 

pop 

ds 

/Pop  DS  off  of  stack 

mov 

dx, offset  removeit 

/Message:  Program  disabled 

mov 

ah,  9 

/Write  function  number  for  string 

int 

21h 

/Call  DOS  function 

mov 

ax, 4C00h 

/Funct.  no.:  End  program 

int 

21h 

/Call  DOS  interrupt  — >  END 

Install  KEYBUF - 


label  near 


; —  In  order  to  configure  new  keyboard  buffer  within  the  — 
; —  PSP,  the  segment  address  must  first  be  moved  to  the  end  — 
; —  of  the  PSP,  where  it  cannot  be  overwritten 


mov 

ax, [2Ch] 

/Load  segment  address  of  environment 

mov 

env_seg,ax 

/and  place  in  code  segment 

mov 

ax, 3509h 

/Get  contents  of  interrupt  vector  9H 

int 

21h 

/Call  DOS  function 

mov 

int9_seg,es 

/Mark  segment  and  offset  address  of 

mov 

int9_ofs,bx 

/interrupt  vector  9H 

mov 

ax,3516h 

/get  contents  of  interrupt  vector  16H 

int 

21h 

/Call  DOS  function 

mov 

intl6_seg,es 

/Mark  segment  and  offset  address  of 

mov 

intl6_ofs,bx 

/interrupt  vector  16H 

cli 

/Disable  interrupt 

mov 

ax,2509h 

/Funct.  no.:  Set  Interrupt  vector  9H 

mov 

dx, offset  new 

_int9 

/Offset  addr.  of  new  int.  9H  handler 

int 

21h 

/Call  DOS  interrupt 

mov 

ax,2516h 

/Funct.  no.:  Set  Interrupt  vector  16H 

mov 

dx, offset  new 

intl6/Offset  addr.  of  new  int.  16H  handler 

int 

21h 

/Call  DOS  Interrupt 

sti 

/Enable  interrupts 

mov 

dx, offset  installm 

/Message:  Install  program 

mov 

ah,  9 

/Function  number  for  string  display 

int 

21h 

/Call  DOS  function 
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Ende 

code 


; —  Just  PSP,  new  interrupt  routine  and  corresponding  - 

; —  data  must  be  resident  - 


mov 

dx, offset  instend 

;Get  offset  address  of  last  byte 

add 

dx,15 

;Make  paragraph  "full" 

mov 

cl,  4 

/Compute  number  of  resident 

shr 

dx,  cl 

/paragraphs 

mov 

ax,3100h 

/Terminate  but  keep  resident  program 

int 

21h 

/with  end  code  of  (0) 

ends 

end 

start 

/End  of  code  segment 
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Appendices  A  to  F  contain  descriptions  of  each  intorupt. 


Appendix  A. 
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713 
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DOS  Intorupts  and  Functions 

766 

Appendix  D. 

EMM  Functions 

849 

Appendix  E. 

EGA/VGA  BIOS  Functions 

856 

Appendix  F. 

Mouse  Driver  Interrupts 

882 

These  descriptions  include  documentation  of  the  interrupt,  any  sub-fiinctions  (if 
applicable)  and  a  listing  of  input  and  output  registers  (if  applicable).  Each  internet 
title  has  the  following  format: 

Interrupt  hex^numberH  Interrupt_type  (i/o_register) 

Interrupt^name 

Every  processor  regist^  important  to  the  called  function  is  mentioned.  Registers 
that  aren't  included  in  this  list  don't  apply  to  the  called  function,  and  can  contain 
any  value  during  the  call  of  the  interrupt 

The  output  listing  identifies  the  register  that  contains  information  returned  by  the 
function  after  the  call  is  completed.  The  register  assignment  depends  on  whethCT  or 
not  the  function  call  is  successfully  executed.  If  a  specific  value  is  supposed  to  be 
in  the  AX  register  after  a  successful  execution,  but  the  function  doesn't  execute 
properly,  then  the  value  in  this  register  won't  have  any  meaning.  Problems  in  each 
function  will  be  addressed  as  needed. 

In  addition  to  the  description  of  the  input  and  output  registers,  details  about  the 
function  may  also  be  included.  For  example,  the  function  may  be  used  in 
conjunction  with  another  function.  There  may  also  be  information  about  any 
changes  in  register  contents  caused  by  the  function  call.  This  is  very  important  to 
the  assembly  language  programmer  who  wants  to  keep  data  in  a  register  after  the 
function  call.  This  programmer  wants  to  avoid  any  changes  in  the  contents  of  the 
registers. 
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interrupts 


Interrupt  OOH  Hardware  (CPU) 

Division  by  zero 

The  CPU  calls  this  intemipt  when  it  encounters  a  divisor  of  0  during  one  of  the 
two  assembly  language  division  instructions  (DIV  or  IDIV).  According  to  the  rules 
of  mathematics,  dividing  a  number  by  0  is  illegal.  During  the  booting  process, 
this  interrupt  points  to  a  routine  that,  when  called,  displays  the  "Division  by  Zero" 
error  message  (or  a  similar  message)  on  the  screen.  The  intemipt  continues  with 
the  execution  of  the  current  program. 

Interrupt  OlH  Hardware  (CPU) 

Single  step 

The  CPU  calls  this  interrupt  when  the  TRAP  bit  in  the  flag  register  of  the  CPU 
has  been  set  to  1.  Then  the  interrupt  is  called  after  the  execution  of  each  assembly 
language  instruction.  This  allows  the  user  to  follow  these  instructions,  determine 
the  changes  in  register  contents  and  determine  which  instructions  are  executed.  To 
prevent  the  call  of  the  interrupt  after  the  execution  of  every  instruction  in  the  trap 
routine  (which  would  create  an  endless  loop  and  a  stack  overflow),  the  processor 
resets  the  TRAP  bit  upon  entry  to  the  trap  routine.  If  the  trap  routine  ends  with 
the  IRET  instruction,  it  automatically  resets  the  TRAP  bit  to  its  old  value  by 
restoring  the  complete  flag  register  from  the  stack.  Because  of  this,  the  execution 
of  the  next  instruction  calls  interrupt  1  again.  Once  the  programmer  has  obtained 
the  necessary  information  about  a  program  from  single  step  mode,  the  TRAP 
mode  (or  TRAP  bit)  can  be  disabled. 
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Interrupt  02H  Hardware  (CPU) 

NMI 


The  hardware  calls  this  interrupt  when  an  error  is  discovered  in  the  RAM  chips. 
The  system  calls  the  non-maskable  intOTupt  because  this  type  of  mor  impairs  the 
capabilities  of  the  system,  and  can  lead  to  a  crash.  The  NMI  has  the  highest 
priority  of  all  interrupts  and  thoefore  is  executed  faster  than  other  int»rupts.  The 
NMI  usually  calls  a  BIOS  routine  which  informs  the  usct  of  a  memory  error,  lists 
the  number  of  defective  memory  chips  and  stops  the  system. 

If  the  NMI  detects  an  error,  the  math  coprocessw  included  in  some  PCs  can  also 
trigger  the  NMI.  Even  though  NMI  usually  cannot  be  suppressed,  the  PC  allows 
an  exception  to  this  rule.  Some  PC/XT  and  AT  models  tove  a  special  port  (port 
AOH  on  PCs  and  XTs,  port  70H  on  ATs).  If  a  0  value  is  written  to  one  of  these 
ports,  the  NMI  interrupt  is  disabled  .  If  Ae  ports  return  the  value  80H,  the  NMI 
interrupt  is  enabled. 

Interrupt  03H  Hardware  (CPU) 

Breakpoint 

While  the  other  interrupts  can  be  called  with  a  two-byte  assembly  language 
instruction  (first  byte  CDH,  second  byte  the  number  of  the  interrupt),  interrupt  3 
is  called  by  the  single-byte  instruction  CCH.  This  interrupt  can  be  used  to  test 
programs  when  you  want  to  execute  the  program  up  to  a  colain  instruction,  then 
stop  and  display  the  current  register  contents.  Utilities  designed  for  program  testing 
like  DEBUG  implement  this  by  placing  calls  for  interrupt  3  where  the  break 
should  occur.  When  the  program  is  executed  and  the  process^  reaches  the 
instruction,  it  calls  interrupt  3.  The  program  testing  utility  contains  a  routine 
which  displays  the  registo'  contents  and  other  information. 

Interrupt  04H  Hardware  (CPU) 

Overflow 

This  interrupt  can  be  called  by  the  INTO  (INTerrupt  on  Overflow)  conditional 
assembly  language  instruction.  The  call  occurs  when  the  overflow  bit  in  the  flag 
register  is  set  during  the  execution  of  the  INTO  instruction.  This  can  happen 
following  math  operations  (e.g.,  multiplication  with  the  MUL  instruction)  that 
produce  a  result  which  cannot  be  represented  within  a  specified  number  of  bits. 
This  interrupt  can  also  be  called  with  the  nmmal  INT  instruction,  but  this 
instruction  isn't  controlled  by  the  status  of  the  set  overflow  bit.  Since  it  is  seldom 
used,  DOS  points  this  interrupt  to  an  IRET  instruction. 

Interrupt  OSH  BIOS 

Hardcopy 

BIOS  calls  this  interrupt  when  the  user  presses  the  <Prt  So  key.  The  system  then 
makes  a  hardcopy  by  sending  the  current  screen  contents  to  a  printer.  BIOS 


711 


Appendix  A  ;  Important  Hardware  Interrupts 


PC  System  Programming 


initializes  the  interrupt  vector  from  the  vectw  table  and  points  to  the  BIOS 
hardcopy  routine  in  ROM-BIOS.  Assembly  language  and  programs  written  in 
higher  level  languages  can  use  this  interrupt  with  the  INT  instruction  to  get  a 
hardcopy  during  inogram  execution. 

Interrupt  OSH  Hardware  (8259  interrupt  controller) 

Timer 


In  the  PC,  the  8259  tuna  chip  receives  1,193,180  signals  pa  second  from  the 
heart  of  the  system,  which  is  an  oscillating  quartz  crystal.  After  65,536  of  these 
signals  (1  second),  it  triggers  a  call  of  intorupt  8,  which  the  8259  transmits  to  the 
CPU.  Since  the  frequency  of  the  call  of  this  interrupt  is  independent  of  the  system 
clock  frequency,  interrupt  8  works  well  for  timekeeping.  Hie  PC  also  uses  the 
interrupt  for  timekeeping.  BIOS  points  the  interrupt  vector  of  this  intorupt  to  its 
own  routine,  which  is  called  18.2  times  per  second.  A  time  counter  increments 
every  second  and  disables  the  disk  drive  motor  if  disk  access  hasn't  occurted  within 
a  cotain  time  poiod. 

Interrupt  09H  Hardware  (8259  interrupt  controller) 

Keyboard 

PC  keyboards  contain  an  indepoident  processor.  This  Intel  processor  carries  either 
the  numba  8048  (PC/XT)  or  8042  (AT).  This  processor  monitors  the  keyboard 
and  registers  whether  a  key  was  depressed  a  released.  When  eitha  of  these  actions 
occur,  this  processor  must  inform  the  CPU  so  that  the  code  of  the  activated  key 
can  be  sent  to  the  system  and  processed.  The  keyboard  instructs  the  interrupt 
controller  to  call  interrupt  9.  This  interrupt  calls  a  BIOS  routine  that  reads  the 
characta  from  the  keyboard  and  places  it  into  the  keyboard  buffa. 
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Interrupt  lOH:  Video  functions 

Function _ Description  _ PageNumbCT 

OOH  Set  video  mode . 716 

OlH  Define  cursor  type . 716 

02H  Position  cursor . 717 

03H  Read  cursor  position . 718 

04H  Read  lightpen  position . 718 

OSH  Select  current  display  page . 719 

06H  Initialize  window/scroll  text  upward . 719 

07H  Initialize  window/scroll  text  downward . 720 

OSH  Read  character/attribute . 720 

09H  Write  character/attribute . 721 

OAH  Write  character . 722 

OBH  Select  palette  (sub-function  0) . 723 

OBH  Select  color  palette  (sub-function  1) . 723 

OCH  Write  graphic  pixel . 724 

ODH  Read  graphic  pixel . 724 

OEH  Write  character . 725 

OFH  Read  display  mode . 726 

13H  Write  character  string  (AT  only) . 726 

Interrupt  IIH:  Determine  configuration . 727 

Interrupt  12H:  Determine  memory  size . 728 

Interrupt  13H:  Disk 

Function _ Description _ Page  Number 

OOH  Reset  floppy  disk  system . 729 

OlH  Read  disk  status . 730 

02H  Read  disk . 731 

03H  Write  to  disk . 731 

04H  Verify  disk  sectors  . 732 
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OSH  Format  trade . 733 

15H  Detamine  drive  type  (AT  only) . 734 

16H  Determine  disk  change  (AT  only) . 73S 

17H  Determine  disk  format  (AT  only) . . . 735 

Interrupt  13H:  Hard  disk 

EuDClicn _ Description _ PageNumbCT 

OOH  Reset  (XT  and  AT  only) . 736 

OlH  Read  disk  status  (XT  and  AT  only) . 736 

02H  Read  disk  (XT  and  AT  only) . 737 

03H  Write  to  disk  (XT  and  AT  only) . 738 

04H  Verify  disk  sectors  (XT  and  AT  only) . 740 

OSH  Format  cylinder  (XT  and  AT  only) . 741 

08H  Check  format  (XT  and  AT  only) . 742 

09H  Adtpt  to  foreign  drives  (XT  and  AT  only) . 743 

OAH  Extended  read  (XT  and  AT  only) . 744 

OBH  Extended  write  (XT  and  AT  only) . 745 

ODH  Reset  (XT  and  AT  only) . 746 

lOH  Drive  ready  ?  (XT  and  AT  only) . 747 

1 IH  Recalibrate  drive  (XT  and  AT  only) . 748 

14H  Controller  diagnostic  (XT  and  AT  only) . 748 

15H  Determine  drive  type  (AT  only) . 749 

Interrupt  14H:  Serial  interface 

Function _ Description  _ Page  Number 

OOH  Initialize  . 750 

OlH  Output  character  . 751 

02H  Input  character . 751 

03H  Read  status . ...752 

Interrupt  15H:  Cassette  interrupt  (AT  only) 

Function _ Description  _ Page  Number 

83H  Set  flag  aftCT  time  interval  (AT  only) . 752 

84H  Read  joystick  fire  button  (sub-function  0)  (AT  only)...753 

84H  Read  joystick  position  (sub-function  1)  (AT  only) . 753 

85H  <Sys  Req>  key  activated  (AT  only) . 754 

86H  Wait  (AT  only) . 754 

87H  Move  memory  areas  (AT  only) . 754 

88H  Determine  memory  size  beyond  1  megabyte  (AT  only)755 

89H  Switch  to  protected  mode  (AT  only) . 755 

Interrupt  16H:  Keyboard 

Function _ Description _ PageNumbCT 

OOH  Read  character  . 756 

OlH  Read  keyboard  fw  character . 756 

02H  Read  keyboard  status  . 757 
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Interrupt  17H:  Parallel  printer 

Eunction - Description  _ PageNumbCT 

OOH  Write  character  . 757 

OlH  Initialize  ininter . 758 

02H  Read  printer  status  . 758 

Interrupt  18H:  Call  ROM  BASIC . 759 

Interrupt  19H;  Boot  process. . 759 

Interrupt  lAH:  Date  and  time 

Eimclmn _ Description  _ PajteNumbCT 

OOH  Read  time  counto' . 759 

OlH  Set  time  counter . 760 

02H  Read  realtime  clock  (AT  only) . 760 

03H  Set  realtime  clock  (AT  only) . 761 

04H  Read  date  from  re^time  clock  (AT  only) . 761 

05H  Set  date  in  realtime  clock  (AT  only) . 762 

06H  Set  alarm  time  (AT  mily) . 762 

07H  Reset  alarm  time  (AT  only) . 763 

Interrupt  IBH:  <Break>  key  pressed . 763 

Interrupt  ICH  Periodic  interrupt . 764 

Interrupt  IDH  Video  table . 764 

Interrupt  lEH  Drive  table . 764 

Interrupt  IFH  Character  table . 765 
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Interrupt  lOH,  function  OOH  BIOS 

Video:  Set  video  mode 

Selects  and  initializes  a  video  mode  and  clears  the  screen.  This  function  is  a  fast 
method  of  clearing  the  screen  while  maintaining  the  current  video  mode. 

Input;  AH=  OOH 

AL=  Video  mode 

0:  40x25  text  mode,  monochrome 
1:  40x25  text  mode,  color 
2:  80x25  text  mode,  monochrome 
3:  80x25  text  mode,  ctdor 
4:  320x200  4-color  graphics 
5:  320x200  4-color  ^phics 

(colors  displayed  in  monochrome) 

6:  640x200  2-color  graphics 
7:  Intonalmode 

Output:  No  ouq)ut 

Remarics:  The  colors  for  modes  4, 5  and  6  can  be  set  with  function  11. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  registos  may  change,  especially  the  SI  and  DI  registm^. 

Interrupt  lOH,  function  OlH  BIOS 

Video:  DeHne  cursor  type 

Defines  the  starting  and  ending  lines  of  the  cursor.  This  cursor  exists  independently 
of  the  current  display  page. 

Input  AH=  OlH 

CH=  Starting  line  of  the  cursor 
CL=  Ending  line  of  the  cursor 

Output  No  output 

Remarks:  The  values  allowed  fw  the  cursor's  starting  and  ending  line  depend  on  the 

installed  video  card.  The  following  values  are  permitted: 


Monochrome  display  cards:  0-13 

Color  display  cards:  0-7 

BIOS  defaults  to  the  following  values: 

Monochnxne  di^lay  cards:  11-12 

Color  display  cards:  6-7 


(color  canQ 
(color  card) 
(monocar^ 
(color  card) 
(color  card) 
(color  card) 

(colOTcard) 

(monocattO 
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You  can  use  this  function  to  set  the  cursor  only  within  the  permitted 
ranges.  Setting  cursor  lines  outside  these  parameters  may  result  in  an 
invisible  cursor  or  system  problems. 

The  contents  of  the  BX,  CX,  DX  registos  and  the  segment  registers  SS, 
CS  and  DS  are  not  affected  by  this  function.  The  contents  of  all  the  other 
registers  may  change,  especially  the  SI  and  DI  registers. 

Interrupt  lOH,  function  02H  BIOS 

Video:  Position  cursor 

Repositions  the  cursor,  which  determines  the  screra  position  for  character  ouq>ut 
by  using  one  of  the  BIOS  functions. 

Input;  AH=  02H 

BH=  Display  page  numba 
DH=  Screen  line 
DL=  Screen  column 

Output:  No  ou^ut 

Remadcs:  The  blinking  cursor  moves  through  this  function  when  the  addressed 

display  page  is  the  current  display  page. 

Values  fOT  the  screen  line  parameto’  range  from  0  to  24. 

Values  for  the  screen  column  parameter  range  from  0  to  79  (fOT  an  80- 
column  display)  or  from  0  to  39  (for  a  40-colomn  display),  depoiding  on 
the  selected  vidm  mode. 

You  can  make  the  cursor  disappear  by  moving  it  to  a  nonexistent  screen 
position  (e.g.,  column  0,  line  25). 

The  numb»  of  the  display  page  parameter  depends  on  how  many  display 
pages  are  available  to  the  video  card. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  registers  may  change,  especially  the  SI  and  DI  registers. 
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Interrupt  lOH,  function  03H  BIOS 

Video:  Read  cursor  position 

Senses  the  text  cursor's  position,  starting  line  and  ending  line  in  a  display  page. 

Input:  AH=  03H 

BH=  Display  page  numba 

Ou^ut:  DH=  Screen  line  in  which  the  cursor  is  located 

DL=  Screen  column  in  which  the  cursOT  is  located 
CH=  Starting  line  of  the  blinking  curscH* 

CL=  Ending  line  of  the  blinking  cursor 

Remaiks:  The  number  of  the  disfday  page  parameter  depends  on  how  many  display 

pages  are  available  to  ^  vi^  card. 

Line  and  column  coordinates  are  related  to  the  text  condinate  system. 

The  contents  of  the  BX  register  and  the  SS,  CS  and  DS  segment  registers 
are  not  affected  by  this  function.  The  contents  of  all  the  other  registo's 
may  change,  especially  the  SI  and  DI  registos. 

Interrupt  lOH,  function  04H  BIOS 

Video:  Read  lightpen  position 

Senses  the  position  of  the  lightpen  on  the  screen  if  ^licable. 

Input  AH=  04H 

Output  AH=  Lighqten  position  reading  status 

0:  Li^tpen  position  unreadable 
1 :  Li^lpen  position  readable 
DH  =  Screen  line  of  the  lightpen  (text  mode) 

DL=  Screen  coluitui  of  the  lighqren  (text  mode) 

CH=  Screen  line  of  the  lightpen  (grtqrhic  mode) 

BXs  Screen  column  of  the  lightpen  (grr^hic  mode) 

Remarks:  This  fuiKtion  call  must  be  rqreated  until  1  is  returned  in  the  AH  registo*, 

because  only  thoi  can  cocndinales  be  read  from  the  otha  registers. 

Coordinates  indicated  repres^t  the  current  video  mode's  resolutitxi. 

Usually  the  coordinates  of  the  li^t  pra  carmot  be  accurately  sensed  in  the 
graphic  mode.  The  Y-coordinate  (line)  is  always  a  multiple  of  2,  so  it 
isn't  possible  to  detomine  whether  the  lighqien  is  in  line  8  or  9.  The  X- 
coordinate  (column)  is  always  a  multiple  of  4  in  320x200  grtqrhic  mode 
and  a  multiple  of  8  in  the  640x200  bitmap  mode. 

The  contents  of  the  CL  registo*  and  the  SS,  CS  and  DS  segment  registers 
are  not  affected  by  this  function.  The  contents  of  all  the  other  registo's 
ituiy  change,  eqrecially  the  SI  and  DI  registos. 
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Interrupt  lOH,  function  OSH  BIOS 

Video:  Select  current  dispiay  page 

Selects  the  current  display  page  (text  mode  only)  which  should  be  displayed. 

AH=  OSH 

AL=  Display  page  numba 
No  output 

The  numbo'  of  the  di^lay  page  d^nds  on  the  numbo'  of  display  pages 
available  to  the  video  card. 

On  switching  to  a  new  display  page,  the  screen  cursor  points  to  the 
positim  of  the  text  cursor  in  this  page. 

Switching  between  various  display  pages  does  not  affect  their  contents 
(the  individual  charact»s). 

You  can  write  characters  to  an  inactive  display  page. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  the 
other  registos,  such  as  the  SI  and  DI  registers,  may  change. 

Interrupt  lOH,  function  06H  BIOS 

Video:  Initialize  window/scroll  text  upward 

Clears  window  or  scrolls  a  portion  of  the  current  display  page  up  by  one  or  more 
lines,  depending  on  the  input 

Input:  AH=  06H 

AL  =  Numba  of  window  lines  to  be  scrolled  iqtward  (0=clear  window) 
CH  =  Screen  line  of  the  upper  left  comer  of  the  window 
CL  =  Screen  column  of  the  upp»  left  ctxner  of  the  window 
DH  =  Screen  line  of  the  lower  right  crnner  of  the  window 
DL  =  Screen  column  of  the  Iowct  right  comer  of  the  window 
BH  =  Color  (attribute)  fw  blank  line(s) 

Output;  No  ouq;)ut 

Remarks;  Initializing  a  window  (placing  a  0  in  the  AL  register)  fills  the  window 

with  blank  spaces  (ASCII  code  32). 

The  contents  of  the  lines  scrolled  out  of  the  window  are  lost  and  cannot 
be  restored. 

Function  0  of  this  intermpt  is  better  for  clearing  the  entire  screen. 


Input: 

OuQ)ut: 

Remarics: 
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The  contents  of  the  BX,  CX,  DX  registers  and  the  SS.  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  legistos  may  change,  especially  the  SI  and  DI  legists. 

Interrupt  lOH,  function  07H  BIOS 

Video:  Initialize  window/scroil  text  downward 

Clears  window  or  scrolls  a  pmtion  of  the  current  display  page  up  by  one  or  more 
lines,  depending  on  the  input. 


Input;  AH=  07H 

AL  =  Numbo*  of  window  lines  to  be  scrolled  downward  (0=clear  window) 

CH  s  Screen  line  of  the  upper  left  cmner  of  the  window 

CL=  Screen  column  of  the  uppCT  left  comer  of  the  window 

DH  =  Screen  line  of  the  lower  right  comer  of  the  window 

DL  =  Screen  column  of  the  Iowct  right  comer  of  the  window 

BH  =  Color  (attribute)  for  blank  line(s) 

Output:  No  output 

Remadcs;  This  function  only  affects  the  current  display  page. 

Initializing  a  window  (placing  a  0  in  the  AL  register)  fills  the  window 
with  blank  spaces  (ASCII  code  32). 

The  contents  of  the  lines  scrolled  out  of  the  window  are  lost  and  cannot 
berestcxed. 

Function  0  of  this  intmupt  is  bett^  for  clearing  the  entire  screen. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  registers  may  change,  especially  the  SI  and  DI  registers. 

Interrupt  lOH,  function  OSH  BIOS 

Video:  Read  character/attribute 

Reads  the  ASCII  code  of  the  character  at  the  current  cursor  position  and  its  color 
(attribute). 

Input:  AH  =  OSH 

BH  =  Display  page  number 

Output:  AL  =  ASCII  code  of  the  character 

AH=  Colo:  (attribute) 
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Remarks:  The  number  of  the  display  page  dqrends  on  the  numbo'  of  display  pages 

made  available  to  the  video  card. 

This  function  can  also  be  called  in  graphic  mode.  The  function  compares 
the  bit  pattern  of  the  character  on  the  screen  with  the  bit  patton  of  the 
character  in  character  ROM  of  the  video  card  and  with  the  character 
patterns  strned  in  a  RAM  table  whose  addresses  i^ipear  in  interrupt  IFH. 
If  the  character  carmot  be  identified,  the  AL  register  contains  the  value  0 
ahet  the  function  call. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  the 
other  regist^  may  change,  especially  the  SI  and  DI  regist^. 

Interrupt  lOH,  function  09H  BIOS 

Video:  Write  character/attribute 

Writes  a  characto'  with  a  cotain  color  (attribute)  to  the  current  cursor  position  in  a 
predefined  di^lay  page. 

Input:  AH=  ()9H 

BH=  Display  page  number 
CX=  Number  of  times  to  write  the  character 
AL=  ASCn  code  of  the  character 
BL=  Attribute 

Output:  No  ou^ut 

Remarks:  If  the  character  should  be  displayed  several  times  (the  value  of  the  CX 

register  is  greater  than  1),  all  characters  must  fit  into  the  cunent  screen 
line  in  the  grrgrhic  mode. 

The  control  codes  (e.g.,  bell,  carriage  return)  ^pear  as  normal  ASCII 
codes. 

This  function  can  display  characto^  in  grtq)hic  mode.  The  patterns  of  the 
characters,  with  the  codes  from  0  to  127,  are  determined  by  a  table  in 
ROM.  The  patterns  of  the  characters  with  the  codes  from  128  to  2SS  are 
determined  by  a  RAM  table  that  was  previously  installed  by  DOS  the 
GRAFTABL  command. 

In  text  mode,  the  contents  of  the  BL  regist»  define  the  attribute  byte  of 
the  character.  In  graphic  mode  this  register  determines  the  color  of  the 
charactCT.  The  640x2(X)  bitmap  mode  only  allows  the  values  0  and  1  for 
selecting  colors  from  the  color  palette.  The  320x200  bitmap  mode  only 
allows  the  values  0  to  3  for  selecting  colors  from  the  color  p^ette. 

If  the  gr^)hic  mode  is  active  during  character  ouqrut  and  bit  7  of  the  BL 
register  is  set,  an  exclusive  OR  is  performed  on  the  character  pattern  and 
the  graphic  pixels  behind  the  character  patton. 
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After  character  output,  the  cursor  remains  in  the  same  position  as  the 
character. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  legists  may  change,  especially  the  SI  and  DI  registers. 

Interrupt  lOH,  function  OAH  BIOS 

Video:  Write  character 

Writes  a  character  to  the  current  cursor  position  in  a  predefined  display  page  by 
using  the  color  of  the  character  previously  at  this  position. 

Input:  AH  =  OAH 

BH=  Display  page  number 

CX=  Number  of  times  to  write  the  character 

AL=  ASQI  code  of  the  charactCT 

Output:  No  output 

Remarics:  If  the  character  should  be  displayed  several  times  (the  value  of  the  CX 

register  is  greater  than  1),  all  characters  must  fit  into  the  current  screen 
line  in  the  grt^hic  mode. 

The  control  codes  (e.g.,  bell,  carriage  return)  tqtpear  as  normal  ASCH 
codes. 

This  function  can  display  characto's  in  graphic  mode.  The  patterns  of  the 
characto's  with  the  o^es  fnxn  0  to  127  are  determined  by  a  table  in  ROM 
and  the  patterns  of  the  characters  with  the  codes  from  128  to  2SS  are 
determined  by  a  RAM  table  previously  installed  by  the  GRAFTABL 
command. 

In  text  mode,  the  contents  of  the  BL  registo*  define  the  attribute  byte  of 
the  character.  In  graphic  mode  this  register  determines  the  color  of  the 
characto'.  The  64()x2(X)  bitmap  mode  only  allows  the  values  0  and  1  for 
selecting  colors  from  the  color  palette.  The  320x200  bitmap  mode  only 
allows  the  values  0  to  3  for  selecting  colors  frx>m  the  color  palette. 

If  the  gng)hic  mode  is  active  during  character  output  and  bit  7  of  the  BL 
register  is  set,  an  exclusive  OR  is  performed  on  the  character  pattern  and 
the  grt^hic  pixels  behind  the  character  patton. 

The  cursor  remains  in  the  same  position  aft^  character  output 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  registm  may  change,  especially  the  SI  and  DI  registers. 
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Interrupt  lOH,  function  OBH,  sub>function  0  BIOS 

Video:  Select  palette 

Selects  the  boidor  and  background  color  for  grs^c  ot  text  nKxie. 

Input:  AH  =  OBH 

BH=  0 

BL=  Bonto/background  color 
Ouq>ut:  No  ou^ut 

Remarks:  In  graphic  mode,  the  color  value  passed  deHnes  the  color  of  both  the 

border  and  background.  In  text  mode,  the  background  color  of  each 
characto*  is  defined  individually,  so  the  passed  color  value  only  defines  the 
color  of  the  screen  harder. 

Values  for  the  color  passed  can  range  from  0  to  IS. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  regist^  may  change,  especially  the  SI  and  DI  registers. 

Interrupt  lOH,  function  OBH,  sub-function  1  BIOS 

Video:  Select  color  palette 

Selects  one  of  the  two  color  palettes  fcv  the  320x200  bitmt^q)ed  graphic  mode. 

Input  AH=  OBH 

BH=  1 

BL=  Color  palette  number 
Output  No  output 

Remarks:  Two  color  palettes  are  available.  They  have  the  numbers  0  and  1  and 

contain  the  following  colors: 

Palette  0:  Green,  red,  yellow 
Palette  1:  Cyan,  magenta,  white 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  aU 
other  registers  may  change,  eiqtecially  the  SI  and  DI  regist^. 
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Interrupt  lOH,  function  OCH  BIOS 

Video:  Write  graphic  pixel 

Draws  a  cokv  pixel  at  the  q>ecified  co(»dinates  in  grEg>hic  mode. 

Input:  AH  =  OCH 

AL=  Pixel  color  value  (see  below) 

BH=  Graphics  page 
CX=  Screen  column 
DX=  Screen  line 

OuQmt:  No  ouQ>ut 

Remarks:  The  pixel  value  color  parameter  depends  on  the  current  grtqrhic  mode. 

640x200  bitmapped  mode  only  permits  the  values  0  and  1.  In  the 
320x200  bitmapp^  mode,  the  values  0  to  3  are  pomitted,  which  gener¬ 
ates  a  certain  color  according  to  the  chosen  color  palette.  0  represents  the 
selected  background  color,  1  represrats  the  first  color  of  the  selected  color 
palette;  2  rqpresents  the  second  color  of  the  color  palette,  etc. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  registers  may  change,  especially  the  SI  and  DI  registers. 

Interrupt  lOH,  function  ODH  BIOS 

Video:  Read  graphic  pixel 

Reads  the  color  value  of  a  pixel  at  the  specified  coordinates  in  the  current  graphic 
mode. 

Input:  AH=  ODH 

DX=  Screen  line 
CX=  Screen  column 

OuQ>ut:  AL  =  Pixel  color  value 

Remarks:  The  pixel  color  value  parameter  depends  on  the  current  graphic  mode. 

640x200  bitmapped  mode  permits  the  values  0  and  1  only.  In  the 
320x200  bitmapp^  mode,  the  values  0  to  3  are  pmnitted,  which  gener¬ 
ates  a  certain  color  according  to  the  color  palette  chosen.  0  rqiresents  the 
selected  background  color,  1  rqnesrats  the  first  color  of  the  selected  cokv 
palette;  2  rqnesents  the  second  color  of  the  color  palette,  etc. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  registers  may  change,  especially  the  SI  and  DI  registos. 
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Interrupt  lOH,  function  OEH  BIOS 

Video:  Write  character 

Writes  a  character  at  the  curroit  cursor  position  in  the  current  display  page.  The 
new  character  uses  the  colw  of  the  character  that  was  previously  in  Ais  position 
on  the  screen. 

Input:  AH=  OEH 

AL=  ASCII  code  of  the  characto* 

BL=  Foreground  color  of  the  characta*  (graphic  mode  only) 

Output:  No  ouQ)ut 

Remarks:  This  function  executes  control  codes  (e.g.,  bell,  carriage  return)  instead  of 

reading  them  as  ASCII  codes.  For  example,  Ae  function  sounds  a  beep 
instead  of  printing  the  bell  character. 

After  this  function  displays  a  character,  the  cursor  position  increments  so 
that  the  next  character  appears  at  the  next  position  on  the  screen.  If  the 
function  reaches  the  last  display  position,  the  display  scrolls  up  one  line 
and  output  continues  in  the  ^t  column  of  the  last  screen  line. 

The  foreground  color  parameter  depends  on  the  current  graphic  mode. 
640x200  bitmapped  mode  only  permits  the  values  0  and  1.  In  the 
320x200  bitmapped  mode,  the  values  0  to  3  are  permitted,  which 
generates  a  certain  color  according  to  the  chosen  color  palette.  0  represents 
the  selected  background  color,  1  represents  the  first  color  of  the  selected 
color  palette;  2  represents  the  second  color  of  the  color  palette,  etc. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
other  registers  may  change,  especially  the  SI  and  DI  registers. 
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Interrupt  lOH,  function  OFH  BIOS 

Video:  Read  display  mode 

Reads  the  numba  of  the  current  video  mode,  the  numbo’  of  charactos  pa  line  and 
the  numbtf  of  the  current  display  page. 

Input:  AH=  OFH 

Output:  AL=  Video  mode 

0:  40x2S  text  mode,  monochrome 
1 :  40x25  text  mode,  color 
2:  80x25  text  mode,  immochrome 
3:  80x25  text  mode,  color 
4:  320x200  4-color  graphics 
5:  320x200  4-color  graphics 

(colors  represented  in  monochrome) 

6:  640x200  2-color  graphics 
7:  Internal  mode 
AH=  Number  of  characto^  per  line 
BH=  Current  display  page  number 

Remarks:  The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 

segment  registers  ate  not  affected  by  this  function.  The  contents  of  all 
other  registers  may  change,  especially  the  SI  and  DI  registers. 

Interrupt  lOH,  function  13H  BIOS  (AT  only) 

Video:  Write  character  string 

Displays  a  character  string  on  the  screen,  starting  at  a  specified  screen  position  on 
a  specified  display  page.  The  characters  are  taken  fi-om  a  buffer  whose  address 
passes  to  the  function. 

AH=  13H 

AL=  Output  mode  (0-3) 

0:  Attribute  in  BL,  retain  cursor  position 
1 :  Attribute  in  BL,  update  cursor  positioi 
2:  Attribute  in  the  buffo',  retain  cursor  position 
3 :  Attribute  in  the  buffo,  update  cursor  position 
BH=  Display  page  numbo 

BL  =  Attribute  byte  of  the  characto  (modes  0  and  1  only) 

BP=  Offset  address  of  the  buffer 
CX=  Numbo  of  charactos  to  be  di^layed 
DH=  display  line 
DL=  display  column 
ES=  segment  address  of  the  buffo 

No  ouQJut 


Input: 


Output: 


(color  card) 
(color  canQ 
(memo  card) 
(color  card) 
(cokocard) 
(color  card) 

(color  card) 
(mono  card) 
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R^naiks:  Modes  1  and  3  set  the  cursw  position  following  the  last  characta  of  the 

character  string.  On  the  next  call  of  a  BIOS  function  fcM*  character  ouQNit, 
the  next  string  of  characters  appears  following  the  original  character 
string.  This  does  not  occur  in  the  modes  0  and  2. 

In  modes  0  and  1,  the  buffin'  contains  mily  the  ASCII  codes  of  the 
characters  to  be  displayed.  The  BL  register  contains  the  color  of  the 
character  string.  However,  in  modes  2  and  3  each  character  has  its  own 
attribute  byte  when  the  chmacter  is  stored  in  the  buffo'.  The  BL  register 
doesn't  have  to  be  loaded  in  this  mode.  Even  though  the  character  string  is 
twice  as  long  in  these  modes  as  the  number  of  the  characters  to  be 
displayed,  the  CX  register  requires  only  the  numbn  of  ASCII  characters 
in  ^  string  and  not  the  total  length  of  the  characto'  string. 

Control  codes  (e.g.,  bell)  ate  interpreted  as  control  codes  only,  and  not  as 
charactos. 

When  the  string  reaches  the  last  position  on  the  screen,  the  display  scrolls 
upward  by  one  line  and  output  continues  in  the  first  column  of  the  last 
screen  line. 

The  contents  of  the  BX,  CX,  DX  registers  and  the  SS,  CS  and  DS 
segment  registers  ate  not  affected  by  this  function.  The  contents  of  all 
other  legists  may  change,  especially  the  SI  and  DI  legists. 


Interrupt  IIH  BIOS 

Determine  configuration 

Reads  the  configuration  of  the  system  as  recorded  during  the  booting  process. 

Input:  No  input 

Output:  AX  =  Configuration 

PC  and  XT:  BitO:  1  if  the  system  has  one  or  more  disk  drives 

Bit  I:  Unused 

Bits  2-3:  RAM  available  on  main  circuit  board 

00:  16K 
01:  32K 
10:  48K 
11:  64K 

Bits  4-5:  Video  mode  afto*  system  boot 

00:  Unused 
01:  40x25,  color  card 
02:  80x25,  color  card 
03:  80x25,  mono  card 

Bits  6-7:  Numba  of  disk  drives  in  the  system  if  bit  0  is  equal  to  1 
00:  1  disk  drive 
01:  2  disk  drives 
10:  3  disk  drives 
11:  4  disk  drives 
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AT; 


Remaiks; 


Bit  8:  0  when  a  DMA  chip  is  present 

Bits  9-11:  Number  of  RS-232  cards  connected 
Bit  12:  1  when  system  has  a  joystick  attached 

Bit  13:  Unused 

Bits  14-15:  Indicates  the  numbCT  of  printos  available 

Bit  0:  1  if  the  system  has  one  or  mme  disk  drives 

Bit  1:  1  when  a  math  coprocesscMr  exists  in  the  system 

Bit  2-3:  Unused 

Bit  4-S:  Video  mode  during  system  boot 

00:  Unused 

01:  40x25,  color  card 

02:  80x25,  color  card 

03:  80x25,  mono  card 

Bits  6-7:  Numb»  of  disk  drives  in  the  system  if  bit  0  is  equal  to  1 

00:  1  disk  drive 

01:  2  disk  drives 

10:  3  disk  drives 

11:  4  disk  drives 

Bit  8:  Unused 

Bits  9-11:  Numbo' of  RS-232  cards  connected 

Bit  12-13:  Unused 

Bits  14-15:  Indicates  the  numbw  of  printos  available 

The  type  of  PC  must  be  known  (PC,  XT  or  AT)  in  order  to  propwly 
interpret  the  meanings  of  the  individual  bits  of  the  configuration  word. 

The  memory  size  indicated  in  bits  2  and  3  of  the  PC/XT  configuration 
word  refers  only  to  the  main  circuit  board.  Interrupt  12H  lets  you 
determine  the  totM  amount  of  available  memory. 

The  video  mode  recorded  in  bits  4  and  5  is  the  mode  that  was  activated 
when  the  system  was  switched  on.  To  detnmine  the  current  video  mode 
use  function  15  of  interrupt  lOH. 

The  contents  of  the  AX  register  are  affected  by  this  function. 


Interrupt  12H  BIOS 

Determine  memory  size 

Input:  No  input 

Output:  AX=  Memory  size  in  kilobytes 

Remarks:  The  PC  and  the  XT  can  accept  a  maximum  of  640K  of  RAM.  The  AT 

accepts  up  to  14  megabytes  of  RAM  memory  beyond  the  1  megabyte 
limit.  The  memory  size  returned  by  this  function  ignores  this  extended 
memory.  To  determine  the  memory  size  beyond  the  1  megabyte  limit, 
use  function  88H  of  interrupt  15H  (available  only  on  the  AT). 

The  contents  of  the  AX  register  are  affected  by  this  function. 
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Interrupt  13H,  function  OOH  BIOS 

Disk:  Reset 

Resets  the  disk  ccHitrollo:  and  any  ctmnected  disk  drives.  A  reset  should  be  executed 
afto*  each  disk  opoation  during  which  an  oror  occurred. 

Input:  AH  =  OOH 

DL=  Oorl 

Output:  Carry  flag=0:  Opoation  completed  (AH=0) 

Carry  fla^l:  (AHserror  code) 

Remarks:  The  value  in  the  DL  register  is  unnecessary  since  all  the  disk  drives 

execute  a  reset  XT  and  AT  models  use  this  register  to  determine  whether 
a  reset  should  be  performed  on  the  disk  drives  or  the  hard  disk. 

The  following  error  codes  can  occur 

OlH:  Function  number  not  permitted 

02H:  Address  not  found 

OSH:  Write  att^pt  on  write  protected  disk 

04H:  Sector  not  found 

OSH:  DMA  ovoflow 

09H:  Data  transmission  beyond  segment  bordn 

lOH:  Read  emx- 

20H:  Error  in  disk  controller 

40H:  Track  not  found 

80H:  Time  out  oror,  unit  not  responding 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  PB  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  13H,  function  OlH  BIOS 

Disk:  Read  status 

Reads  the  status  of  the  disk  drive  since  the  last  disk  opoadon. 

Input:  AH=  OlH 

DL=  Oor  1 

Output:  Carry  flag=0:  Operadon  completed  (AH=0) 

Carry  flag=l:  Errw  (AH=CTror  code) 

Remarks:  The  value  in  the  DL  register  is  unnecessary,  since  disk  drives  constantly 

return  their  status.  XT  and  AT  models  use  this  register  to  determine 
whetho-  the  status  of  the  hard  disk  should  be  checked. 
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The  following  aior  codes  can  occur. 

OlH;  Functimi  number  not  permitted 

02H:  Address  not  found 

OSH:  Write  attempt  on  write  protected  disk 

04H:  SectOT  not  found 

OSH:  DMA  ovCTflow 

09H:  Data  transmission  beyond  segment  bord^ 

lOH:  Read  error 

20H:  Error  in  diric  controller 

40H:  Track  not  found 

80H:  Time  out  ertor,  unit  not  responding 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  PB  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 


Interrupt  13H,  function  02H  BIOS 

Disk:  Read  disk 

Reads  one  more  disk  sectors  into  a  buffer. 

Input:  AH=  02H 

AL=  Numbo- of  sector  to  be  read 
BX=  Offish  address  of  buffer 
CH=  Track  numbo* 

CL=  Sectw  number 

DH=  Disk  side  number  (0  or  1) 

DL=  Didt  drive  number 
ES=  Buffer  segment  address 

Ou4)ut:  Carry  flagM):  Opoation  completed  (AH=0) 

Cany  fla^l:  Enor  (AH=arorcode) 

Remark:  The  number  of  sectors  to  be  read  into  the  AL  register  is  limited  to  sectors 

which  logically  follow  each  otho*  on  a  track  on  one  side  of  the  disk. 
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The  following  enw  codes  can  occur 

OlH:  Function  number  not  permitted 

02H:  Address  not  found 

OSH:  Write  attonpt  on  a  write  protected  disk 

04H:  Sectm  not  found 

OSH:  DMA  overflow 

09H:  Data  transmission  over  segment  bcndo* 

lOH:  Readenor 

20H:  Eiiot  in  disk  controller 

40H:  Track  not  found 

80H:  Time  out  error,  drive  not  reqxmding 

The  contents  of  the  BX.  CX.  DX.  SI,  DI,  BP  registers  and  the  segment 
registo's  are  not  affected  by  this  function.  The  contents  of  all  the  other 
registos  may  change. 


Interrupt  13H,  function  OSH  BIOS 

Disk:  Write  to  disk 

Writes  one  or  more  sectors  to  a  disk.  The  data  to  be  bansmitted  are  taken  from  a 
buffer. 

Input:  AH  =  OSH 

AL=  Numbo*  of  sectors  to  be  writtm 
BX=  Offset  address  of  buffo* 

CH=  Track  numbo 

CL=  Sector  number 

DH=  Disk  side  number  (0  or  1) 

DL=  Disk  drive  number 
ES=  Buffer  segment  address 

Output*  Cany  flag=0:  Opoation  completed  (AH=0) 

Carry  fla^l:  Error  (AH=error  code) 

Remark:  The  number  of  sectors  that  can  be  written  in  the  AL  register  is  limited  to 

sectors  which  logically  follow  each  other  on  a  track  on  one  side  of  the 
disk. 

The  foUowing  error  codes  can  occur 

OlH:  Function  number  not  permitted 

02H:  Address  not  found 

OSH:  Write  attempt  on  a  write  protected  disk 

04H:  Sector  not  found 
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08H:  DMA  overflow 

09H;  Data  transmission  over  segment  boid^ 

lOH:  Readenor 

20H:  Error  in  disk  controller 

40H:  Track  not  found 

80H:  Time  out  error,  drive  not  responding 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registo^  may  change. 

Interrupt  13H,  function  04H  BIOS 

Disk:  Verify  disk  sectors 

Compares  one  or  more  sectors  on  disk  with  the  data  stored  in  a  buffer.  This  can  be 
used  to  verify  that  the  data  was  properly  saved  to  disk. 

Input:  AH=  04H 

AL=  Number  of  sectors  to  be  verified 
BX=  Offset  address  of  buffer 
CH=  Track  number 
CL=  Sectornumber 
DH  =  Disk  side  number  (0  or  1) 

DL=  Disk  drive  number 
ES  =  Buff^  segment  address 

Output:  Carry  flag=0:  Operation  completed  (AH=0) 

Carry  flag=l:  Error  (AH^emx  code) 

Remarks:  The  number  of  sectors  to  be  verified  in  the  AL  register  is  limited  to 

sectors  which  logically  follow  each  other  on  a  track  on  one  side  of  the 
disk. 

The  following  error  codes  can  occur: 

OlH:  Function  number  not  permitted 

02H:  Address  not  found 

03H:  Write  attempt  on  a  write  protected  disk 

04H:  Sector  not  found 

OSH:  DMA  overflow 

09H:  Data  transmission  over  segment  border 

lOH:  ReadOTCM* 

20H:  Error  in  disk  controller 

40H:  Track  not  found 

80H:  Time  out  error,  drive  not  responding 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 
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Interrupt  13H,  function  OSH  BIOS 

Disk:  Format  track 

Formats  a  complete  track  on  one  side  of  a  disk.  A  buffer  which  contains 
infonnation  about  the  secuws  to  be  formatted  must  be  passed  to  the  function. 

AH=  OSH 

ALs  Numba  of  sectors  to  be  formatted 
BX=  Offset  address  of  buffw 
CH=  Track  numba 
DH=  Disk  side  number  (0  (v  1) 

DL  =  Disk  drive  numbo* 

ES=  Buffer  segment  address 

Carry  flag=0:  Operation  completed  (AH=0) 

Cany  f]ag=l;  Era  (AHsoror  code) 

Remark:  The  number  of  sectors  to  be  formatted  is  limited  to  sectors  which 

logically  follow  each  other  <^a  track  on  one  side  d  the  disk. 

The  buffer  passed  in  ES:BX  contains  an  entry  consisting  of  four 
consecutive  bytes  for  evety  sector  to  be  formatted. 

1:  Track  numba 

2:  Page  number 

3:  Logical  sector  number 

4:  Number  of  bytes  in  this  sector 

0:  128  bytes 
1:  256  bytes 

2:  512  bytes  (PC  standarcQ 
3:  1,024  bytes 

The  logical  sector  number  increments  continuously,  but  may  not  be  the 
same  as  the  physical  sector  number. 

The  following  oror  codes  can  occur 

OlH:  Function  number  not  permitted 

02H:  Address  not  found 

03H:  Write  attempt  on  a  write  protected  disk 

04H:  Sector  not  found 

OSH:  DMA  ovoflow 

09H:  Data  tranmiission  over  segmrat  boido* 

lOH:  Read  error 

20H:  Error  in  disk  controller 

40H:  Track  not  found 

80H:  Time  out  error,  drive  not  resprading 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registo-s  are  not  affected  by  this  function.  The  contents  of  all  the  other 
regist^  may  change. 


Input* 


OuQ>ut 
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Interrupt  13H,  function  15H  BIOS  (AT  only) 

Disk:  Determine  drive  type 

Senses  disk  change  and  drive  type.  The  AT  suppwts  both  the  standard  320/360K 
drives  and  the  1.2  megabyte  drives. 

AH=  15H 

DL  =  Diric  drive  numba  (0  or  1) 

Carry  flag=0:  Op»ation  completed  (AH=unit  type) 

AH=0:  Device  not  present 
AH=1:  Unit  does  not  recognize  disk  change 
AH=2:  Unit  recognizes  disk  change 
AH=3:  Hard  disk  (see  remarks  below) 

Carry  flag=l:  Error 

The  AT  has  a  controller  which  selectively  controls  2  disk  drives  and  a 
hard  disk,  or  one  disk  drive  and  2  hard  disks.  In  the  latter  case,  the  first 
hard  disk  has  the  number  1  and  can  be  accessed  with  this  function. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  13H,  function  16H  BIOS  (AT  only) 

Disk:  Media  change 

Senses  a  disk  change.  The  AT  supports  both  the  standard  320/360K  drives  and  the 
1.2  megabyte  drives.  This  function  reads  any  disk  change  that  may  have  occurred 
since  the  last  disk  access. 

Input:  AH=  16H 

DL  =  Diric  drive  number  (0  or  1) 

Output'  AH=():  No  disk  change 

AH=6:  Disk  changed  since  last  disk  access 

Remarks:  The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 

registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 


Input: 

OuQ)ut: 

Remark: 
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Interrupt  13H,  function  17H  BIOS  (AT  only) 

Disk:  Determine  disk  format 

Detomines  the  fxHinat  of  a  disk.  The  ATs  1.2  megabyte  disk  drive  can  read  both 
320/360K  disks  and  1.2  megabyte  disks.  While  the  BIOS  can  determine  disk 
fwmat  during  a  read  or  write  access,  it  first  must  be  informed  of  the  format 
Function  23  must  be  called  on  the  AT  brfore  you  can  call  function  S  (ftHmat). 

Input:  AH=  17H 

AL=  Fmmat 

AL=1: 320/360K  f<»mat  on  320/360K  drive 
AL=2: 32(V360K  format  on  12  megabyte  drive 
AL=3: 1.2  megabyte  format  tm  1.2  megabyte  drive 

OuQ)ut:  Carry  flag=0:  Opoation  completed 

Carry  flag=l:  Error 

Remark:  The  following  enot  codes  can  occur 

OlH:  Function  number  not  permitted 

02H:  Address  not  found 

03H:  Write  attempt  cm  a  write  protected  disk 

(MH:  Sector  not  found 

OSH:  DMA  ovoflow 

09H:  Data  transmission  over  segment  bcwdo' 

lOH:  Readenor 

20H:  Error  in  disk  controller 

40H:  Track  not  found 

80H:  Time  out  error,  drive  not  respcmding 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 
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Interrupt  13H,  function  OOH  BIOS  (XT  and  AT  only) 

Hard  disk:  Reset 

Resets  the  haid  disk  controller  and  any  interfaced  hard  didc  drives.  A  reset  should  be 
executed  afta  evoy  hard  disk  opoation  during  which  an  mat  was  tepooed. 

Input:  AH=  (X)H 

DL=  SOHotSIH 

Output;  Carry  flag=0:  Opoation  completed  (AH=0) 

Carry  flag=l:  Error  (AH=aiDr  code) 

Remarks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  numbo'  81H. 

The  value  in  the  DL  regista  is  unnecessary  since  all  the  hard  disk  drives 
execute  a  reset.  XT  and  AT  models  use  this  registo^  to  determine  whether 
a  reset  should  be  performed  on  the  disk  drives  or  on  the  hard  disk. 

The  following  ernH*  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Error  on  controller  reset 

07H:  Error  during  controUa  initialization 

09H:  DMA  transmission  mar  Segment  borda  exceeded 

OAH:  Defective  sector 

lOH:  Read  error 

IIH:  ReadararctHiectedbyECC 

20H:  Conuollo' defect 

40H;  Search  r^roation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unitnotready 

CCH:  Write  mor 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registm^  may  change. 


Interrupt  13H,  function  OlH  BIOS  (XT  and  AT  only) 

Hard  disk:  Read  disk  status 

Reads  the  status  of  the  hard  disk  since  the  last  hard  disk  opoation. 

Input:  AH=  OlH 

DL=  80Hor81H 

Output:  Carry  fiag=0;  Opoation  completed  (AH=0) 

Cany  flag=l;  Error  (AH=aTQr  code) 
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Ronaiks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  numba  81H. 

The  value  in  the  DL  register  is  unnecessary  since  the  status  is 
consistently  returned  for  each  disk  drive.  XT  and  AT  models  use  this 
register  to  determine  whether  the  status  of  the  disk  drives  or  hard  disk 
should  be  checked. 

The  following  oror  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Enxv  on  controUu'  reset 

07H:  Eiror  during  controllo*  initialization 

09H:  DMA  transmission  oron  Segment  border  exceeded 

OAH:  Defective  sectw 

lOH:  Readenor 

IIH:  ReadmxvconectedbyECC 

20H:  ControU^  defect 

40H:  Search  operation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  OTw 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affect^  by  this  function.  The  contents  of  the  other 
registos  may  change. 


Interrupt  13H,  function  02H  BIOS  (XT  and  AT  only) 

Hard  disk:  Read  disk 

Reads  one  or  m(»e  hard  disk  sectors  into  a  buffer. 

Input:  AH=  02H 

AL=  Number  of  sectors  to  be  read  (1-128) 

BX=  Offset  address  of  buffer 
CH=  Cylinder  numba* 

CL=  Sector  number 
DH=  Read/write  head  numbo' 

DL=  Hard  disk  numba  (80H  or  81H) 

ES=  Buffer  segment  address 

Output:  Carry  flag=0:  Operation  completed  (AH=0) 

Carry  flag=l:  Error  (AH=CTr»  code) 
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Ronailcs:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 

Since  the  eight  bits  of  the  CH  register  can  address  only  256  cylinders  at  a 
time,  bits  6  and  7  of  the  CL  register  (sectcw  numba*)  fmin  bits  8  and  9  of 
the  cylinder  number,  which  enables  the  addressing  of  up  to  1,023 
cylinders  at  a  time. 

If  sev^al  sectcvs  are  being  read  and  the  system  reaches  the  last  sector  of  a 
cylinder,  reading  continues  at  the  first  secUM*  of  the  next  cylinder  of  the 
next  lead/wiite  head.  If  the  system  reaches  the  last  readAvrite  head,  reading 
continues  on  the  first  sector  of  the  following  cylinder  on  the  first 
read/wrilehead. 

The  following  oror  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H;  Sector  not  found 

OSH:  Error  on  controller  reset 

07H:  Error  during  controller  initialization 

09H:  DMA  transmission  mor  Segment  border  exceeded 

OAH:  Defective  sectm* 

lOH;  Read  mar 

IIH:  Read  CTTor  corrected  by  ECC 

20H:  Contrc^er  defect 

40H:  Search  operation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  error 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 


Interrupt  13H,  function  03H  BIOS  (XT  and  AT  only) 

Hard  disk:  Write  to  disk 

Writes  one  or  more  sectors  to  the  hard  disk.  The  data  to  be  transmitted  are  taken 
from  a  buffer  in  the  calling  program. 

Input:  AH=  OSH 

AL  =  Numbo'  of  sectors  to  be  written  (1-128) 

BX=  Offset  address  of  buffo' 

CH=  Cylinder  number 
CL=  Secto  number 
DH=  Read/write  head  numbo 
DL=  Hard  disk  number  (80H  or  8 IH) 

ES=  Buffo  segment  adcbess 
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Output: 

Remaiks: 


Cany  flag=0:  Operation  comfrieted  (AHsO) 

Cany  flag=:l:  Era  (AHsenor  code) 

The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 
assigned  the  numbo*  81H. 

Since  the  eight  bits  of  the  CH  register  can  address  only  2S6  cylinders  at  a 
time,  bits  6  and  7  of  the  CL  register  (sectOT  numbo:)  fcHm  bits  8  and  9  of 
the  cylinder  numbo',  enabling  the  addressing  of  up  to  1,023  cylindos  at  a 
time. 

If  several  sectcHS  are  being  written  and  the  system  reaches  the  last  secttH* 
of  a  cylinder,  writing  continues  at  the  first  secttx'  of  the  next  cylinder  of 
the  next  read/wiite  head.  If  the  system  reaches  the  last  read/write  head, 
writing  continues  on  the  first  sector  of  the  following  cylindo*  on  the  first 
reaiVwritehead. 

The  following  rarcH'  codes  can  occur: 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Emv  on  controller  reset 

07H:  Errm:  during  controller  initialization 

09H:  DMA  transmission  enor  Segment  bordo*  exceeded 

OAH:  Defective  sector 

lOH:  Read  enor 

IIH:  Read  oror  corrected  by  ECC 

20H:  Controllo' defect 

40H:  Search  opoation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  enw 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 
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Interrupt  13H,  function  04H  BIOS  (XT  and  AT  only) 

Hard  disk:  Verify  disk  sector 

Verifies  one  or  more  seckMS  of  a  hard  disk.  Unlike  the  corresponding  floppy  disk 
function,  the  data  on  the  hard  disk  are  not  compared  with  Ae  data  in  memory. 
During  data  storage,  four  check  bytes  are  stmed  fin*  every  sector,  these  check  bytes 
verify  the  contents  of  a  sector. 


Input:  AH  =  04H 

AL=  Numb^  of  sectors  to  be  voified  (1-128) 

BX=  Offset  address  of  buffer 
CH=  Cylindn  number 
CL=  Sector  number 
DH=  Read/write  head  numbo’ 

DL=  Haiddisknumb»(80Hor81H) 

ES=  Buffo’ segment  address 

Output:  Carry  flag=0:  Opoation  completed  (AH=0) 

Carry  flag=l:  Error  (AH=oror  code) 

Remarks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  numbo  81H. 

Since  the  eight  bits  of  the  CH  register  can  only  address  256  cylinders  at  a 
time,  bits  6  and  7  of  the  CL  register  (sector  numbo)  form  bits  8  and  9  of 
the  cylinder  number,  which  enables  the  addressing  of  up  to  1,023 
cylinders  at  a  time. 

If  several  sectors  are  being  voified  and  the  system  reaches  the  last  sector 
of  a  cylinder,  verification  continues  at  the  first  sector  of  the  next  cylinder 
of  the  next  read/write  head.  If  the  system  reaches  the  last  read/write  head, 
verification  continues  on  the  first  sector  of  the  following  cylinder  on  the 
first  read/write  head. 

Die  following  mor  codes  can  occur: 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Error  on  controller  reset 

07H:  Error  during  controU^  initialization 

09H:  DMA  transmission  mor  Segment  borda  exceeded 

OAH:  Defective  sector 

lOH:  Read  error 

IIH:  Read  error  corrected  by  E(X 

20H:  Controll^  defect 

40H:  Search  opoation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  error 
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The  contents  of  the  BX,  CX.  DX,  SI,  DI,  BP  legists  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registns  may  change. 

Interrupt  13H,  function  OSH  BIOS  (XT  and  AT  only) 

Hard  disk:  Format  cylinder 

Formats  a  complete  cylinder  (17  sectors)  of  a  hard  disk.  A  buffer,  which  contains 
infomation  abwt  the  sectors  to  be  fwmatted,  must  be  passed  to  the  function. 

Input:  AH  =  OSH 

AL=  17 

BX=  Of^  address  of  buffor 
CH=  Cylindo' numb^ 

CL=  1 

DH=  ReacVwrite  head  numbo’ 

DL=  Haiddisknumba'(80Hor81H) 

ES=  Buffer  segmott  address 

Output:  Cany  flag=0:  Opoation  completed  (AH=0) 

Carry  fla^l:  (AH=enOT  code) 

Remaiks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 

Since  the  eight  bits  of  the  CH  register  can  only  address  256  cylinders  at  a 
time,  bits  6  and  7  of  the  CL  register  (sectm*  numba)  fmn  bits  8  and  9  of 
the  cylinder  number,  which  enables  the  addressing  of  up  to  1,023 
cylinders  at  a  time. 

Since  a  complete  cylinder  is  always  formatted,  the  first  sector  to  be 
formatted  in  the  CL  register  is  always  sector  1.  For  the  same  reason  the 
number  of  sectors  to  be  formatted  in  the  AL  register  is  always  17,  since 
the  av^uge  hard  disk  operates  with  17  sectors  per  cylindo’. 

The  buffer,  whose  address  is  passed  in  ES:BX,  must  always  be  at  least 
512  bytes  long.  Only  the  first  34  bytes  of  this  buffer  are  used  for 
formatting  the  17  sectors  of  a  cylinder.  Two  succeeding  bytes  contain 
information  about  the  corresponding  physical  sector.  Before  the  function 
call,  the  first  byte  isn't  significant.  After  the  fimction  call  the  first  byte 
indicates  whether  or  not  the  sector  could  be  fixmatted  ((X)H)  or  (80H).  The 
second  byte  returns  the  logical  sector  number  of  the  physical  sector  and 
must  be  placed  in  the  buffer  by  calling  the  program  before  the  function 
call. 
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The  following  eaor  codes  can  occur 

OlH;  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Error  on  controller  reset 

07H:  Emn*  during  controllo'  initialization 

09H:  DMA  transmission  oror  Segment  bord^  exceeded 

OAH:  Defective  sector 

lOH:  Read  error 

IIH:  Read  mor  corrected  by  ECC 

20H:  Controllo*  defect 

40H:  Search  (^toatioa  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  OTor 

The  contents  of  the  BX,  CX,  DX,  SI,  Dl,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 

Interrupt  13H,  function  OSH  BIOS  (XT  and  AT  only) 

Hard  disk:  Check  format 

Conveys  the  fomatting  information  found  on  the  hard  disk. 

Input:  AH  =  OSH 

CH  =  Cylindo'  numbo' 

CL=  Secttx*  number 

DH=  Read/write  head  number  (Oe=first  head) 

DL=:  Hard  disk  numb^ 

Output:  Carry  flag=0:  Operation  comideted  (AH=0) 

Carry  flag=l:  E^  (AH=mor  code) 

Remarks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 

Since  the  eight  bits  of  the  CH  register  can  address  only  256  cylinders  at  a 
time,  bits  6  aiid  7  of  the  CL  register  (sector  number)  form  bits  8  and  9  of 
the  cylinder  numba,  enabling  the  addressing  of  up  to  1,023  cylind^  at  a 
time. 

The  total  capacity  of  the  hard  disk  unit  in  bytes  can  be  calculated  with  the 
following  formula: 

Capacity  =  Heads  *  Cylinders  *  Sectors  *  512 
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The  following  otdt  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Error  on  conttx>ller  reset 

07H:  Error  during  controllo’  initialization 

09H:  DMA  transmissitm  error  Segment  horda  exceeded 

OAH:  Defective  sector 

lOH:  Read  error 

IIH:  Readaiorc(»iectedbyECC 

20H:  ControUo' defect 

40H:  Search  opoation  failed 

80H:  Time  out,  unit  not  re^nding 

AAH:  Unit  not  ready 

CCH:  Write  OTOT 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 


Interrupt  13H,  function  09H  BIOS  (XT  and  AT  only) 

Hard  disk:  Adapt  to  foreign  drives 

Intrafaces  otha  hard  disk  drives  for  access  through  BIOS  functions. 

Input:  AH=  09H 

DL=  Numb^of  harddisktobeint^aced(80Hor81H) 

Output:  Cany  flag^  Opoation  completed  (AH=0) 

Cany  flag=l:  Errw  (AH=error  code) 

Remarks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 

BIOS  takes  the  information  about  the  hard  disk  drive  to  be  interfaced 
(number  of  units,  read/write  heads,  etc.)  from  a  table.  The  address  of  this 
table  for  the  hard  disk  unit  numbaed  80H  is  stored  in  interrupt  vector 
41H,  and  the  unit  numbered  81H  is  stored  in  interrupt  46H. 

The  following  oror  codes  can  occur: 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Error  on  controller  reset 

07H:  Error  during  controUer  initialization 

09H:  DMA  transmission  oror  Segment  txxder  exceeded 

OAH:  Defective  secttv 

lOH:  Read  error 

IIH:  Read  mor  corrected  by  ECC 
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20H:  Controllo'  defect 

40H;  Search  opaation  failed 

80H:  Time  out,  unit  not  re^nding 

AAH:  Unit  not  ready 

CCH:  Write  oror 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 


Interrupt  13H,  function  OAH  BIOS  (XT  and  AT  only) 

Hard  disk:  Extended  read 

Reads  one  or  more  sectors  from  the  hard  disk  drive  into  a  buffa*.  Besides  the  actual 
512  bytes  sttxed  in  the  sector,  the  function  also  reads  the  four  check  bytes  (ECC). 

Input;  AH  =  OAH 

AL=  NumbCT  of  sectors  to  be  read  (1-127) 

BX=  Offset  address  of  buffo' 

CH=  Cylinder  number 
.  CL=  Secto*  number 
DH  =  Read/write  head  numbo 
DL=  Harddisknumbo(80Hor81H) 

ES=  Buffo  segment  address 

Output:  Carry  flag=0:  Operation  completed  (AH=0) 

Carry  flag=l:  Error  (AH=enor  code) 

Remarks;  The  flrst  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 

Normally  the  controller  computes  the  four  check  bytes.  Here  the  buffer 
reads  the  information  direct 

Since  the  eight  bits  of  the  CH  register  can  only  address  256  cylinders  at  a 
time,  bits  6  and  7  of  the  CL  register  (sector  numbo)  form  bits  8  and  9  of 
the  cylinder  number,  enabling  the  addressing  of  up  to  1,023  cylindos  at  a 
time. 

If  several  sectors  are  being  read  and  the  system  reaches  the  last  sector  of  a 
cylinder,  reading  continues  at  the  first  sector  of  the  next  cylinder  of  the 
next  read/write  head.  If  the  system  reaches  the  last  read/write  head,  reading 
continues  on  the  first  sector  of  the  following  cylinder  on  the  first 
read/write  head. 

The  following  error  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H;  Address  not  found 

04H:  Sector  not  found 

05H:  Error  on  controller  reset 
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07H:  Error  during  controller  initialization 

09H;  DMA  transmission  error  Segment  bordo*  exceeded 

OAH;  Defective  sector 

lOH:  Read  error 

IIH;  ReadororccHrectBdbyECXr 

20H:  Controllo^  defect 

40H:  Search  opoatioi  failed 

80H:  Time  out,  unit  not  reqxmding 

AAH:  Unit  not  ready 

CCH:  Write  error 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  13H,  function  OBH  BIOS  (XT  and  AT  only) 

Hard  disk:  Extended  write 

Writes  one  or  more  sectors  to  the  hard  disk  drive.  Besides  the  actual  512  bytes 
stored  in  a  sector,  four  check  bytes  (ECC)  stored  at  the  end  of  every  sector  are 
transmitted  from  the  buffer. 

Input:  AH=  OBH 

AL=  Numbo' of  sectors  to  be  read  (1-127) 

BX=  Offset  address  of  buffo' 

CH=  Cylindonumbo 
CL=  Sectcxnumbo 
DH=  ReacVwrite  head  numbo 
DL=  Hard  disk  numbo(80H  or  81H) 

ES=  Buffo  segment  address 

Output:  Cany  flag=0:  Opoation  completed  (AH=0) 

Carry  flag=l:  E^  (AH=OTor  code) 

Remarks:  The  flrst  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  numbo  81H. 

Normally  the  controller  calculates  the  four  check  bytes.  Hoe  the  system 
reads  them  direct  fron  the  buffo. 

Since  the  eight  bits  of  the  CH  register  can  only  address  256  cylinders  at  a 
time,  bits  6  and  7  of  the  CL  register  (sector  numbo)  form  bits  8  and  9  of 
the  cylinder  numbo,  enabling  the  addressing  of  up  to  1,023  cylinders  at  a 
time. 

If  several  sectors  are  being  written  and  the  system  reaches  the  last  sector 
of  a  cylindo,  writing  continues  at  the  first  sectca  of  the  next  cylinder  of 
the  next  read/write  head.  If  the  system  teaches  the  last  read/write  head, 
writing  continues  on  the  first  sector  of  the  following  cylindo  on  the  first 
read^vrite  head. 
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Hie  following  oixm'  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H;  Address  not  found 

04H;  Sectcv  not  found 

OSH:  Error  on  controller  reset 

07H:  Eitot  during  controlla:  initialization 

09H:  DMA  transmission  error  Segmoit  borda*  exceeded 

OAH:  Defective  sector 

lOH:  Read  error 

IIH:  Read  error  corrected  by  ECC 

20H:  ContTollOT  defect 

40H;  Search  opoation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  «ror 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registo^  may  change. 


Interrupt  13H,  function  ODH  BIOS  (XT  and  AT  only) 

Hard  disk:  Reset 

Resets  the  hard  disk  contrails  and  any  intofaced  hard  disk  drives.  A  reset  should  be 
executed  after  every  hard  disk  qieration  during  which  an  orw  was  reported. 

Input  AH=  ODH 

DL=  Hard  disk  drive  number  (80H  or  81H) 

Output  Carry  flag=0:  Operation  completed  (AH=0) 

Carry  flag=l:  Enxv  (AH=aror  code) 

Remarks:  The  value  in  the  DL  regista  is  unnecessary  since  all  the  hard  disk  drives 

execute  a  reset  XT  and  AT  models  use  this  registo*  to  determine  whether 
a  reset  should  be  performed  on  the  disk  drives  or  on  the  hard  disk. 

This  function  is  identical  to  function  0  listed  above. 

The  Erst  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 
assigned  the  numb»  81H. 

Hie  following  oror  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Error  on  controller  reset 

07H:  Error  during  controlla  initialization 

09H:  DMA  transmission  ator.  Segment  border  exceeded 

OAH:  Defective  sector 
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20H:  Controlla' defect 

40H:  Search  operation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  error 


The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 


Interrupt  13H,  function  lOH  BIOS  (XT  and  AT  only) 

Hard  disk:  Drive  ready? 

Determines  if  the  drive  is  ready  (i.e.,  the  last  operation  has  bera  completed  and  the 
drive  can  perform  the  next  task). 


Input:  AH=  lOH 

DL=  Hard  disk  drive  number  (80H  OT  81H) 

Output:  Carry  flag=0:  Drive  ready  (AH=0) 

Carry  fla^l:  Eirw  (AH=aTor  co^) 

Remarirs:  The  rirst  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  numb^  81H. 

The  following  error  codes  can  occur. 

OlH:  Addressed  hinction  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  EtTW  on  controller  reset 

07H:  Error  during  controller  initialization 

09H:  DMA  transmission  mm:  Segmrat  bord^  exceeded 

OAH:  Defective  secto' 

lOH:  Readeinx' 

IIH:  Read  enxx  corrected  by  ECC 

20H:  ControUo' defect 

40H:  Search  operation  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  emx 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 
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Interrupt  13H,  function  IIH  BIOS  (XT  and  AT  only) 

Hard  disk:  Recalibrate  drive 

Recalibrates  hard  disk  aiter  an  »ror  occurs,  eq)ecially  ato  a  read  or  write  oror. 


Input:  AH=  IIH 

DL=  Hard  disk  drive  number  (80H  or  8 IH) 

Output:  Cany  {lag=0:  Opoation  comideted  (AH=0) 

Carry  flag=l:  Emr  (AH=«iorcode) 

Remarks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 

The  following  oror  codes  can  occur 

OlH:  Addressed  fimction  (w  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Error  on  controller  reset 

07H:  EnxH'  during  controllo:  initialization 

09H:  DMA  Uansmission  enon  Segmoit  bordo'  exceeded 

OAH:  Defective  sector 

lOH:  Read  error 

IIH:  Read  mor  corrected  by  ECC 

20H:  Controllo*  defea 

40H:  Search  opaadon  failed 

80H:  Time  out,  unit  not  responding 

AAH:  Unit  not  ready 

CCH:  Write  oror 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registm  may  change. 


Interrupt  13H,  function  14H  BIOS  (XT  and  AT  only) 

Hard  disk:  Controller  diagnostic 

Initializes  an  internal  diagnostic  test  of  the  hard  disk  controlla. 


Input:  AH-  14H 

DLs  Hard  disk  drive  number  (80H  or  8 IH) 

Output*  Carry  llag=():  Opoadon  completed  (AH=0) 

Carry  flag=l:  Error  (AH=aior  code) 

Remadcs:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 
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The  following  onH*  codes  can  occur 

OlH:  Addressed  function  or  unit  not  available 

02H:  Address  not  found 

04H:  Sector  not  found 

OSH:  Enor  on  conboller  reset 

07H:  Error  during  controllo'  initialization 

09H:  DMA  transmission  enor  Segment  bonier  exceeded 

OAH:  Defective  sector 

lOH:  Read  error 

IIH:  ReadoTorctHiectedbyECC 

20H:  Contiolla' defect 

40H:  Search  opoation  failed 

80H:  Time  out.  unit  not  re^nding 

AAH:  Unit  not  ready 

CCH:  Write  raror 

The  contents  of  the  BX,  CX.  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 


Interrupt  13H,  function  15H  BIOS  (AT  only) 

Hard  disk:  Determine  drive  type 

Determines  whetha  or  not  the  compute'  hardware  assigned  numbers  80H  and  81H 
are  hard  di^  drives.  The  AT  contains  a  controll^  capable  of  controlling  both  hard 
disks  and  disk  drives.  This  controller  can  manage  either  two  disk  drives  and  one 
hard  disk,  or  one  disk  drive  and  two  hard  disks. 

Input:  AH=  15H 

DLs  Hard  disk  drive  number  (80H  or  8 IH) 

Output:  Carry  flag=():  Operation  completed  (AH=drive  type) 

0:  Equipment  not  available 
1:  Drive  does  not  recognize  disk  change 
2:  Drive  recognizes  disk  change 
3:  Hard  disk  unit 
Carry  flag=l:  Error  (AH=CTrOT  code) 

Remarks:  The  first  hard  disk  drive  is  assigned  the  number  80H,  the  second  is 

assigned  the  number  81H. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 
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Interrupt  14H,  function  OOH  BIOS 

Serial  port:  Initialize 

Initializes  and  configures  a  serial  port  This  configuration  includes  parameters  for 
word  length,  baud  rate,  parity  and  stop  bits. 

Input:  AH  =  OOH 

DX  =  Number  of  serial  port  ((>=first  serial  port,  l=second  serial  port) 

AL=  Configuration  parameters 
Bits  0-1:  Word  length 

10(b)  =  7  bits 
11(b)  =  8  bits 

Bit  2:  Number  of  stop  bits 

00(b)  =  1  stop  bit 
01(b)  =  2  stop  bits 
Bits  3-4:  Parity 

00(b)  =  none 
01(b)  =  odd 
1 1^)  =  even 
Bits  5-7:  Baud  rate 

000(b)  =110  baud 
001(b)  =150  baud 
010(b)  =  300  baud 
011(b)  =  600baud 
100(b)  =1200  baud 
101(b)  =  2400  baud 
110(b)  =  4800  baud 
lll(b)  =  9600baud 

Output:  AH=  Serial  port  status 

Bit  0:  Data  ready 
Bit  1:  Overrun  error 
Bit  2:  Parity  error 
Bit  3:  Framing  error 
Bit  4:  Break  discovered 
Bit  5:  Transmission  hold  register  empty 
Bit  6:  Transmission  shift  register  empty 
Bit  7:  Time  out 
AL=  Modem  status 

Bit  0:  Modem  ready  to  send  status  change 

Bit  1:  Modem  on  status  change 

Bit  2:  Telephone  ringing  status  change 

Bit  3:  Connection  to  receiver  status  change 

Bit  4:  Modem  ready  to  send 

Bit  5:  Modem  on 

Bit  6:  Telephone  ringing 

Bit  7:  Connection  to  receiver  modem 

Remarks:  The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 

registers  are  not  affected  by  this  function.  The  contents  of  all  the  other 
registers  may  change. 
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Interrupt  14H,  function  OlH  BIOS 

Serial  port:  Send  character 

Sends  a  character  to  the  soial  port 

Input:  AH=  OlH 

DX  =  Number  of  serial  port  (Oefirst  serial  port,  l=second  serial  ptxt) 
AL=  QiaractOT  code  to  be  soit 

Output'  AH:  Bit  7  =  0:  ChariK;ter  transmitted 

Bit  7=  1:  Error 
Bit  0-b:  Serial  port  status 
Bit  0:  Data  ready 
Bit  1:  Ovnrun  mtw 
Bit  2:  Parity  error 
Bit  3:  Framing  etiot 
Bit  4:  Break  discovoed 
Bit  S:  Transmission  hold  register  empty 
Bit  6:  Transmission  shift  registo’  empty 

Remadcs:  The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 

registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registo's  may  change. 

Interrupt  14H,  function  02H  BIOS 

Serial  port:  Read  character 

Receives  a  character  from  the  serial  pwL 

Input:  AH=  02H 

DX  =  Number  of  serial  port  (0=first  serial  port,  l=second  serial  port) 

OuQ)ut:  AH:  Bit  7  =  0:  Charact^  received: 

AL  =  CharactCT  received 

Bit7  =  1:  Error 

Bit  0-6:  Serial  port  status: 

Bit  0:  Data  ready 

Bit  1:  Ovarun  cttot 

Bit  2:  Parity  errw 

Bit  3:  Framing  earn 

Bit  4:  Break  discovered 

Bit  S:  Transmission  hold  register  empty 

Bit  6:  Transmission  shift  register  empty 

Remaiks:  This  function  should  only  be  called  if  function  3  has  determined  that  a 

charactCT  is  ready  for  recq>tion. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 
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Interrupt  14H,  function  03H  BIOS 

Serial  port:  Read  status 


Reads  the  status  of  the  serial  port. 


Input: 


OuQtut: 


Remarks: 


AH=  03H 

DX  =  Numbo*  of  the  serial  pent  (the  first  soial  prat  has  the  numbra*  0) 

AH=  Serial  port  status 
Bit  0:  Datareatfy 

Bit  1:  Overrun  eaot 

Bit  2:  Parity  rarer 

Bit  3:  Framing  rarer 

Bit  4:  Break  discovraed 

Bit  S:  Transmission  hold  registra  empty 
Bit  6:  Transmission  shift  register  empty 

AL=  Modem  status: 

Bit  0:  Modem  ready  to  send  status  change 

Bit  1:  Modem  on  status  change 

Bit  2:  Telephone  ringing  status  change 

Bit  3:  Connection  to  receiver  status  change 

Bit  4:  Modem  ready  to  send 

Bit  5:  Modem  on 

Bit  6:  Telephone  ringing 

Bit  7:  Connection  to  receivra  modem 

This  function  should  always  be  called  before  calling  function  2  (read 
charactra). 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 


Interrupt  15H,  function  83H  BIOS  (AT  only) 

Cassette  interrupt:  Set  flag  after  time  interval 

Sets  bit  7  of  a  flag  to  1  aftra  a  certain  amount  of  time  in  microseconds  elapses. 


Input  AH=  S3H 

ES=  Segment  address  of  the  flag 

BX=  Offset  address  of  the  flag 

CX=  Hi^  word  of  ek^sed  time  in  miraoseconds 

DX=  Low  word  of  eh^sed  time  in  microseconds 

Output  No  ou^ut 

Remarics:  A  microsecond  is  a  millionth  of  a  second. 

The  contents  of  the  BX,  SI,  DI,  BP  registers  and  the  segment  registers  are 
not  affected  by  this  function.  The  contents  of  all  other  registers  may 
change. 
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Interrupt  15H,  function  84H,  sub-function  0  BIOS  (AT  only) 

Cassette  interrupt:  Read  joystick  switch  settings 

Reads  the  status  of  switches  on  joysticks  interfaced  to  a  PC,  if  game  ports  and 
joysticks  are  present. 


Input:  AH=  84H 

DX=  0 

OuQ>ut:  Carry  flag=l:  No  game  port  connected 

Carry  flag=0:  Game  port  present: 

AL  =  Switch  settings: 

Bit  7=1:  First  joystick's  first  switch  oiabled 
Bit  6=1:  First  joystick's  second  switch  enabled 
Bit  5=1:  Second  joystick's  first  switch  enabled 
Bit  4=1:  Second  joystick's  second  switch  enabled 

Remarks:  Sub-function  1  reads  the  joystick  position(s). 

The  contents  of  the  BX,  CX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  15H,  function  84H,  sub-fiinction  1  BIOS  (AT  only) 

Cassette  interrupt:  Read  joystick  position 

Reads  the  positions  of  joysticks  interfaced  to  a  PC  if  game  ports  and  joysticks  are 
present 


Input:  AH=  84H 

DX=  1 

Ouq>ut:  Carry  flag=l:  No  game  port  connected 

Carry  flag=0:  Game  port  present: 

AX  =  X-posidon  of  first  joystick 
BX  =  Y-position  of  first  joystick 
CX  =  X-position  of  second  joystick 
DX  =  Y-position  of  second  joystick 

Remarics:  Sub-function  0  reads  the  joystick  switch  status. 

The  contents  of  the  SI,  DI,  BP  registers  and  the  segment  registers  are  not 
affected  by  this  function.  The  contents  of  all  other  registers  may  change. 
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Interrupt  15H,  function  85H  BIOS  (AT  only) 

Cassette  interrupt:  <Sys  Req>  key  activated 

Responds  to  {uessure  or  release  of  the  <Sys  Req>  key.  The  keyboard  routine  calls 
this  function. 


Input: 

AH=  85H 

AL=  0:  <SysReq>key  dqrressed 

AL=  1:  <Sys  Re^  key  released 

OuQ)ut: 

No  ou4>ut 

Remarks: 

This  function  acts  as  an  intermediary  fa  ai^lication  programs,  so  that  the 
application  program  will  respoid  igrpropriately  when  the  usa  presses  the 
<Sys  Req>  key. 

Interrupt  15H,  function  86H  BIOS  (AT  only) 

Cassette  interrupt:  Wait 

Returns  control  to  the  calling  program  after  a  cotain  amount  of  time  has  elapsed. 


Input: 

AH=  86H 

CX=  High  word  of  pause  time  in  microseconds 
DX=  Low  word  of  pause  time  in  microseconds 

Output: 

No  ouQ>ut 

Remadcs: 

A  microsecond  is  a  millionth  of  a  second. 

The  contents  of  the  BX,  SI,  DI,  BP  registers  and  the  segment  registos  are 
not  affected  by  this  function.  The  contents  of  all  other  registers  may 
change. 

Interrupt  15H,  function  87H 

Cassette  interrupt:  Move  memory  areas 

BIOS  (AT  only) 

Moves  areas  of  RAM  from  below  the  1  megabyte  limit  to  the  range  above  the  1 
megabyte  limit,  and  from  above  the  1  megabyte  limit  to  below  the  1  megabyte 
limit. 


Input:  AH=  87H 

CX=  Number  of  wads  to  move 

ES  =  Segment  address  of  global  descripta  table 

SI=  Offset  addressed  global  descr^ta  table 

Output:  Carry  flag=0:  No  ora 

Carry  f]ag=l:  Error 

AH=1:  RAM  parity  erra 

AH=2:  Incorrect  GDT  on  function  call 

AH=3:  Rrotected  mode  could  na  be  initialized 
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R^naiks:  See  Section  7.10.1  to  nKHe  information  about  the  global  descripttH'  table 

(GDT). 

Only  words  can  be  transtored;  individual  bytes  cannot  be  tianstoied. 

Maximum  amount  of  memory  allowed  in  a  transto  is  64K.  Hie  value  in 
the  CX  regista  cannot  exceed  8000H. 

All  interrupts  are  disabled  during  the  memory  block  move. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 

Interrupt  15H,  function  88H  BIOS  (AT  only) 

Cassette  interrupt:  Determine  memory  size  beyond  1  megabyte 

Determines  the  amount  of  memory  installed  beyond  the  1  megabyte  limit. 

Input:  AH  =  88H 

Output:  AX=  Memory  size 

Remarks:  The  value  in  the  AX  registo'  rqnesents  memory  in  kilobytes  (K). 

Memory  size  below  the  1  megabyte  limit  can  be  determined  using 
interrupt  12H. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
regist^  may  change. 

Interrupt  15H,  function  89H  BIOS  (AT  only) 

Cassette  interrupt:  Switch  to  virtual  mode 

Switches  the  80286  processor  to  virtual  mode. 


Input:  AH=  89H 

Output:  No  output 

Remarks:  This  function  should  be  called  only  if  you  know  how  virtual  mode 

opoates.  Improp»  use  of  this  function  can  easily  lead  to  a  system  crash. 
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Interrupt  16H,  function  OOH  BIOS 

Keyboard:  Read  character 

Reads  a  character  from  the  keyboard  buffer.  If  the  buffer  doesn't  contain  a  charact^, 
the  function  waits  until  a  character  is  entered.  Then  the  character  is  read  and 
removed  from  the  keyboard  buffer. 

Input:  AH  =  OOH 

Output:  AL  =  0:  Extended  k^  code: 

AH  =  Extended  key  code 
AL>1:  Normal  key  activated: 

AL  =  ASCII  code  of  key 
AH  =  Scan  code  of  key 

Remarks:  ASCII  code  definition  occurs  independent  of  the  keyboard.  Scan  codes 

apply  only  to  the  type  of  keyboard  attached  to  the  PC.  See  Appendix  J  for 
a  list  of  ASCn  codes  and  Section  7.11  for  a  list  of  extended  key  codes. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  I6H9  function  OlH  BIOS 

Keyboard:  Read  keyboard  for  character 

Reads  the  keyboard  buffer  for  a  character  ready  to  be  entered.  If  a  character  is 
available,  the  function  passes  the  character  to  the  calling  function.  The  character 
remains  in  the  keyboard  buffer  and  can  be  re-read  when  a  program  calls  either 
function  0  (see  above)  or  function  1.  The  function  returns  to  the  calling  program 
immediately  after  the  call. 

Input:  AH=  OlH 

Output:  Zero  flag  =  1:  No  character  in  the  keyboard  buffer 

Zero  flag  =  0:  Character  available  in  keyboard  buffer: 

AL  =  0:  Extended  key  code: 

AH  =  Extended  key  code 
AL>1:  Normal  key: 

AL  =  ASCII  code  of  the  key 
AH  =  Scan  code  of  the  key 

Remarks:  ASCII  code  definition  occurs  independent  of  the  keyboard.  Scan  codes 

only  apply  to  the  type  of  keyboard  attached  to  the  PC.  See  Appendix  J  for 
a  list  of  ASen  codes  and  Section  7. 1 1  for  a  list  of  extended  key  codes. 

The  contents  of  the  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 
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Interrupt  16H,  function  02H  BIOS 

Keyboard:  Read  keyboard  status 

Reads  and  returns  the  status  of  cettaia  contrd  leys  and  various  keyboard  noodes. 
Input:  AH=  02H 

Output:  AL=  Keyboard  status 


Keyboard  status 

Remarks:  The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 

registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  17H,  function  OOH  BIOS 

Printer:  Write  character 

Writes  a  characto'  to  one  of  the  printers  int^aced  to  the  PC. 

Input:  AH  =  OOH 

AL=  Characto^ code  to  be  printed 
DX=  Printer  number 

Output:  AHs  Printer  status: 

Bit  0=1:  Time  out  error 
Bit  1:  Unused 
Bit  2:  Unused 
Bit  3=1:  TransCo'  otot 
Bit  4=0:  PrintCT  offline 
Bit  4=1:  PrintCT  online 
Bit  5=1:  Printer  out  of  paper 
Bit  6=1:  Receive  mode  selected 
Bit  7=0:  Printer  busy 
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Remaiks:  Parallel  port  LPTl  is  assigned  the  number  0,  parallel  port  LPT2  is 

assigned  the  number  1  and  parallel  pwt  LFT3  is  assigned  the  number  2. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 

Interrupt  17H,  function  OlH  BIOS 

Printer:  Initialize  printer 

Initializes  the  printer  intofaced  to  the  PC.  This  function  should  be  executed  before 
executing  function  0  (see  above). 

Input;  AH=  OlH 

DX=  Printer  number 

OuQ)ut:  AH=  Printer  status 

Remaiks:  Parallel  port  LPTl  is  assigned  the  number  0,  parallel  port  LPT2  is 

assigned  the  number  1  and  parallel  port  LFT3  is  assigned  the  number  2. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registos  may  change. 

Interrupt  17H,  function  02H  BIOS 

Printer:  Read  printer  status 

Returns  the  status  of  the  printa*  interfaced  to  the  PC. 

Input:  AH=  02H 

DXs  Printer  number 

Output:  AH=  Printer  status 

Remaiks:  Parallel  port  LPTl  is  assigned  the  number  0,  parallel  port  LPT2  is 

assigned  the  number  1  and  parallel  port  LPT3  is  assigned  the  number  2. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
regist^  may  change. 
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Interrupt  18H  BIOS 

Call  ROM  BASIC 

Accesses  BASIC  in  ROM  if  a  system  disk  cannot  be  found  during  the  system 
bootstr^inocess. 

Input:  No  input 

Output:  No  ouq>ut 

Remaiks:  Very  few  PCs  or  compatibles  have  built-in  ROM  BASIC  (this  is  a 

throwback  from  the  early  days  of  the  PQ.  If  a  PC  doeai't  have  ROM 
BASIC,  interrupt  18H  returns  the  system  to  the  calling  program. 
However,  if  the  PC  does  has  ROM  BASIC,  intmupt  18H  c^s  BASIC. 
In  most  cases,  the  only  way  to  return  to  IX)S  is  by  warm-starting  the 
computer  (pressing  the  <Ctrl><Alt><Delete>  keys)  or  turning  the 
compute  off  and  on  again.  Some  vmions  of  ROM  BASIC  allow  an  exit 
to  DOS  by  entering  the  SYSTEM  command  from  BASIC. 


Interrupt  19H  BIOS 

Boot  process 

Boots  the  compute. 

Input:  No  input 

Output:  No  ou^ut 

Remaiks:  Pressing  the  <Ctrl><Alt><Delete>  keys  invokes  this  interrupt  from  the 

keyboard. 

Interrupt  lAH,  function  OOH  BIOS 

Date  and  time:  Read  clock  count 

Reads  the  current  clock  count  The  clock  count  increments  18.2  times  per  second. 
This  calculates  the  time  elapsed  since  the  compute  was  switched  on. 

Input:  AH  =  OOH 

Output:  CX=  High  word  of  the  clock  count 

DX=  Low  word  of  the  clock  count 

AL  =  0:  Less  than  24  hours  have  elapsed  since  the  last  reading 
ALoO:  More  than  24  hours  have  elapsed  since  the  last  reading 
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R^naiks:  The  AT,  which  has  a  battery  powered  realtime  clock,  sets  the  clock  count 

to  the  current  time  when  the  ctnnputer  boots.  PCs  (which  don't  have 
realtime  clocks)  set  the  counter  to  0  during  booting. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  otho*  regis- 
t^  may  change. 

Interrupt  lAH,  function  OlH  BIOS 

Date  and  time:  Set  clock  count 


Sets  the  contents  of  the  current  clock  count,  which  increments  18.2  times  per 
second.  This  calculates  the  time  elapsed  since  the  computer  was  switched  on  and 
sets  the  current  time  through  this  function. 


Input: 

AH=  OlH 

CX=  High  word  of  clock  count 

DX=  Low  wwd  of  clock  count 

Output 

No  output 

Remarks: 

The  AT,  which  has  a  battery  powoed  realtime  clock,  sets  the  clock  count 
to  the  current  time  when  the  ctnnputer  boots.  PCs  (which  don't  have 
realtime  clocks)  set  the  counter  to  0  during  booting.  PC  owners  should 
use  this  function  to  set  the  current  time. 

The  contents  of  the  AX,  BX,  CX,  DX,  SI,  DI,  BP  registers  and  the 
segment  registers  are  not  affected  by  this  function.  The  contents  of  all 
otha*  registos  may  change. 

Interrupt  lAH,  function  OlH  BIOS  (AT  only) 

Date  and  time:  Read  realtime  clock 

Reads  the  time  from  the  realtime  clock. 


Input:  AH=  02H 

Output:  Carry  flag  =  0: 0,K.: 

CH  =  Hours 

CL  =  Minutes 

DH=  Seconds 

Carry  flag  =  1:  Dead  clock  battery 

Remarks:  All  time  readings  tqrpear  in  BCD  format 

The  contfflts  of  the  BX,  SI,  DI,  BP  registers  and  the  segment  registers  are 
not  affected  by  this  function.  The  contents  of  all  other  registers  may 
change. 
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Interrupt  lAH,  function  03H  BIOS  (AT  only) 

Date  and  time:  Set  realtime  clock 

Sets  the  time  on  the  realtime  clock. 

Input:  AH  =  OSH 

CH=  Hours 
CL=  Minutes 
DH=  Seconds 

DL  =  1:  Daylight  Saving  Time 
DL=  0:  Standard  Time 

OuQ)ut:  No  output 

Remarks:  All  time  settings  must  be  in  BCD  format 

The  contents  of  the  BX,  SI,  DI,  BP  iegist»s  and  the  segment  registers  are 
not  affected  by  this  function.  The  contents  of  all  other  registers  may 
change. 

Interrupt  lAH,  function  04H  BIOS  (AT  only) 

Date  and  time:  Read  date  from  realtime  clock 

Reads  the  current  date  frmn  the  realtime  clock. 

Input:  AH»  04H 

Output:  Cany  flag  =  0: 0.K.: 

CH  =  Century  (19  or  20) 

CL=  Year 

DH=  Month 

DL=  Day 

Carry  flag  =  1:  Dead  clock  battoy 

Remarks:  All  date  readings  appear  in  BCD  format 

The  contents  of  the  BX,  SI,  DI,  BP  registers  and  the  segment  regist^  are 
not  affected  by  this  function.  The  contents  of  all  other  registers  may 
change. 
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Interrupt  lAH,  function  OSH  BIOS  (AT  only) 

Date  and  time:  Set  date  in  realtime  clock 

Sets  the  current  date  in  the  realtime  clock. 

Input:  AH  =  OSH 

CH=  Century  (19  or  20) 

CL  =  Year 
DH=  Month 
DL=  Day 

Output:  No  ou4)ut 

Remarks:  All  date  settings  must  be  in  BCD  format. 

The  contents  of  the  BX,  CX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  lAH,  function  06H  BIOS  (AT  only) 

Date  and  time:  Set  alarm  time 

Sets  alarm  time  for  the  current  day.  The  alarm  time  triggers  interrupt  4AH. 


Input:  AH=  06H 

CH=  Hours 
CL=  Minutes 
DH=  Seconds 

Output:  Carry  flag=0: 0.K. 

Carry  flag=l:  Dead  clock  batt^  prograrruned  alarm  time. 

Remarks:  All  alarm  settings  must  be  in  BCD  format. 

During  booting,  interrupt  4AH  points  to  an  IRET  command.  If  this 
interrupt  doesn't  point  to  a  particular  routine  responding  to  the  alarm, 
nothing  will  happen  once  the  alarm  time  is  reached. 

Only  one  alarm  time  can  be  active  at  a  time.  If  another  alarm  setting 
already  exists,  you  must  first  delete  it  by  using  interrupt  26-lAH, 
function  7  (see  below). 

The  contents  of  the  BX,  CX,  SI,  DI,  BP  registers  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registas  may  change. 
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Interrupt  lAH,  function  07H  BIOS  (AT  only) 

Date  and  time:  Reset  alarm  time 

Cleats  an  existing  alarm  setting  created  by  using  function  06H  above. 

Input:  AH=  07H 

OuQ)ut:  No  output 

Remarks:  This  function  must  be  called  when  you  want  to  change  an  alarm  setting. 

Reset  the  alarm,  then  use  function  06H  to  set  the  new  alarm  time. 

The  contents  of  the  BX,  CX,  SI,  DI,  BP  registm  and  the  segment 
registers  are  not  affected  by  this  function.  The  contents  of  all  otho* 
registm  may  change. 


Interrupt  IBH  BIOS/DOS 

Keyboard:  <Break>  key  pressed 

Records  the  occurrence  of  a  <Ctrl><Break>  key  comlnnation  and  triggos  intemqrt 
IBH.  During  the  system  boot,  BIOS  sets  interrupt  IBH  to  an  IRET  command  in 
ordo^  to  prevent  any  reaction. 

This  routine  sets  a  flag  to  indicate  that  the  user  has  pressed  <CtrlxBreak>. 
Following  the  execution  of  one  of  the  DOS  functions,  this  flag  is  tested  for 
character  input  or  output.  If  the  system  encounters  <Ctrl><Break>,  the  current 
program  stops.  In  addition,  when  a  batch  file  is  in  process,  the  program  asks 
whetha  the  batch  file  should  be  continued  w  tmninated. 

Pressing  <Ctrl><C>  doesn't  activate  the  interrupL  This  key  combination  forces 
DOS  to  end  the  currently  executing  program.  However,  the  DOS  functions  fOT 
character  input/output  search  for  this  Irey  combination. 

To  prevent  termination  of  an  application  program,  this  interrupt  can  also  be 
pointed  to  a  uso*  routine  by  pressing  <Break>  or  <CtrlxBreak>. 

Input*  No  input 

OuQiut:  No  output 

Remarks:  Before  returning  control  to  the  calling  program,  this  interrupt  must 

restore  all  registers  to  their  previous  values. 
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Interrupt  ICH  BIOS 

Periodic  interrupt 

The  timo'  IC  calls  interrupt  8H  t^jfnoximately  18.2  times  per  second.  Afto'  ending 
its  task,  it  calls  interrupt  ICH  in  order  to  allow  an  implication  program  access  to 
the  signals  from  the  timer  IC.  During  booting,  BIOS  initializes  the  interrupt 
vector  of  interrupt  ICH  so  that  it  points  to  an  IRET  command,  which  prevents 
any  response  if  the  interrupt  is  called.  Fot  example,  this  intempt  can  be  pointed  to 
a  uso*  routine  to  create  a  constant  display  clodr  on  the  screen. 

Input:  No  input 

Ouput:  No  ouput 

Remarks:  This  interrupt  must  restore  all  registers  to  their  previous  values  before 

returning  control  to  the  calling  program. 


Interrupt  IDH  BIOS 

Video  table 

Sets  a  pointer  to  a  table.  The  vector  of  this  interrupt  in  the  vector  table,  starting  at 
address  0000:0074,  stores  the  offset  and  segment  address  of  this  table.  The  table 
itself  contains  a  collection  of  parameters  used  by  BIOS  for  initializing  a  certain 
video  mode.  This  involves  the  16  memory  locations  on  the  video  card,  whose  heart 
is  a  6845  video  processor.  For  this  reason  the  table  to  which  the  vector  points  and 
which  is  part  of  the  ROM-BIOS,  consists  of  16  consecutive  bytes  that  indicate  the 
contents  of  individual  registers  for  a  certain  video  mode.  The  Erst  of  these  16  bytes 
is  copied  into  the  first  register  of  the  6845,  the  second  byte  into  the  second 
register,  etc.  The  table  in  ROM  contains  a  total  of  four  16-byte  entries:  40x25 
color  mode,  80x25  color  mode,  80x25  monochrome  mode  and  one  entry  for  the 
various  color  grtphics  modes. 

Do  not  call  this  interrupt.  If  you  do,  the  system  will  attempt  to  read  the  video 
table  as  executable  code  and  will  crash. 

Input:  No  input 

Ouput:  No  ouput 

Interrupt  lEH  BIOS/DOS 

Drive  table 

Sets  a  pointer  to  a  table.  The  vector  of  this  interrupt  in  the  vector  table  starting  at 
address  0000:0078  stores  the  offset  and  segment  address  of  this  table.  The  table 
itself  contains  a  collection  of  paramet^  used  by  BIOS  in  disk  drive  access.  BIOS 
has  a  table  in  ROM,  but  deviates  the  interrupt  vector  of  interrupt  30  to  its  own 
table  which  allows  faster  disk  access  than  the  BIOS  table  (see  Section  7.7  for  more 
information  about  this  table). 
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Do  not  call  this  inteirupL  If  you  do  call  it,  the  system  will  attempt  to  read  the 
drive  t^le  as  executable  code  and  will  crash. 

Input:  No  input 

Ou^ut;  No  output 

Interrupt  IFH  BIOS/DOS 

Character  table 

Sets  a  pointer  to  a  table.  The  vecttM’  of  this  interrupt  in  the  vector  table,  starting  at 
address  0000:007C,  st(»es  the  offset  and  segment  address  of  this  table.  The  table 
itself  contains  character  patterns  for  the  characters  possessing  ASCII  codes  128  to 
2S5.  BIOS  needs  this  table  in  ordo’  to  display  the  graphic  mode  characters  on  the 
screen.  These  characters  are  displayed  by  placing  the  character  pattmis,  which  are 
stored  in  this  table,  on  the  screen  as  individhial  pixels. 

Since  the  character  patterns  for  codes  0  to  127  are  already  stored  in  a  table  in 
ROM-BIOS,  this  table  contains  only  the  character  patterns  for  codes  128  to  255. 
The  DOS  GRAFTABL  command  loads  a  table  for  codes  127  to  255  into  RAM  and 
points  the  interrupt  vector  of  interrupt  31  to  this  table.  A  user  table  can  be  added  to 
display  on  the  screen,  in  graphic  mode,  certain  characters  that  are  not  part  of  the 
normal  PC  character  set.  The  construction  of  the  table  requires  that  eight 
consecutive  bytes  define  the  ^>pearance  of  the  characto*.  The  first  eight  bytes  of  the . 
table  define  the  ^pearance  of  ASCII  code  128,  the  next  eight  bytes  define  ASCII 
code  129,  etc.  Each  set  of  eight  bytes  represent  the  eight  lines  which  denote  a 
characto-  in  graphic  mode.  The  eight  bits  of  each  byte  indicate  the  eight  columns 
of  pixels  for  each  line. 

Do  not  call  this  interrupt.  If  you  do  call  it,  the  system  will  attempt  to  read  the 
chaiacto'  table  as  executable  code  and  will  crash. 

Input:  No  input 

Output:  No  ouqnit 
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Function  Description  _ PageNumbCT 

Interrupt  20H  Terminate  program . 773 

Interrupt  21H  functions — arranged  by  function  groups 
Character  input 

Function  Description _ PaecNumbCT 

OlH  Character  input  with  echo  (Ver.  1  and  up) . 773 

03H  Auxiliary  input  (Ver.  1  and  up) . 775 

06H  Direct  console  VO  (Ver.  1  and  up) . 776 

07H  UnfUtered  character  input  without  echo 

(Vct.  1  and  up) . 777 

OSH  Characta  input  without  echo  (Ver.  1  and  up) . 778 

OAH  Buffered  input  (Ver.  1  and  up) . 779 

OBH  Get  input  status  (Ver.  1  and  up) . 780 

OCH  Reset  input  buffer  and  then  input  (Ver.  1  and  up) . 780 

Character  output 

Function _ Description _ PageNumbCT 

02H  Characta  output  (Vct.  1  and  up) . 774 

04H  Auxiliary  output  (Vct.  1  and  up). . 775 

05H  Printer  output  (Ver.  1  and  up) . 776 

06H  Direct  console  lA)  (Vct.  1  and  up) . 776 

09H  Output  character  string  (Ver.  1  and  up) . 778 

Program  termination 

Function  Description _ PaeeNumbCT 

OOH  TCTminate  program  (Vct.  1  and  up) . 773 

31H  TCTminate  and  stay  resident  (Vct.  2  and  up) . 799 

4CH  Terminate  with  return  code  (Vct.  2  and  up) . 825 
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Subdirectory  access 

Function  Description _ PaeeNumbCT 

39H  Create  subdirectory  (Ver.  2  and  up) . 804 

3AH  Delete  subdirectory  (Va.  2  and  up) . 805 

3BH  Set  current  directory  (Ver.  2  and  up) . 805 

47H  Get  current  directory  (Va-.  2  and  up) . 821 

RAM  control 

Function  Description _ Page  Number 

48H  Allocate  memory  (Ver.  2  and  iq)) . 821 

49H  Release  memory  (Ver.  2  and  up) . 822 

4AH  Modify  memory  allocation  (Ver.  2  and  up) . 822 

58H  Get  allocation  strategy  (sub-function  0) 

(Va.  3  and  up) . 830 

58H  Sa  allocation  strategy  (sub-function  1) 

(Va.  3  and  up) . 830 

Device  driver  access 

Functioa _ Description _ PageNumba 

44H  lOCTL:  Get  device  info  (sub-function  0) 

(Va.  2  and  up) . 813 

44H  lOCTL:  Set  device  info  (sub-fimction  1) 

(Va.  2  and  up) . 813 

44H  lOCTL:  Read  data  from  diaracta  device 

(sub-function  2)  (Ver.  2  and  up)..... . 814 

44H  lOCTL:  Send  d^  to  chaiacta  device 

(sub-fimction  3)  (Ver.  2  and  up) . 815 

44H  lOCTL:  Read  data  from  block  device 

(sub-function  4)  (Va.  2  and  up) . 816 

44H  lOCTL:  Said  data  to  block  device 

(sub-function  5)  (Ver.  2  and  up) . 816 

44H  lOCTL:  Read  input  status 

(sub-function  6)  (Va.  2  and  up) . 817 

44H  lOCTL:  Read  output  status 

(sub-function  7)  (Ver.  2  and  up) . 817 

44H  lOCTL:  Test  for  changeable  block  device 

(sub-funcdai  8)  (Va.  3  and  up) . 818 

44H  KXriL:  Test  fa  local  or  remote  drive 

(sub-function  9)  (Va.  3.1  and  up) . 818 

44H  lOCTL:  Test  fa  local  a  remote  handle 

(sub-function  10)  (Va.  3.1  and  up) . 819 

44H  lOCTL:  Change  retry  count 

(sub-function  11)  (Ver.  3  and  up) . 819 

Time  and  date 

Euncticn _ Description _ PageNumba 

2AH  Ga  system  date  (Va.  1  and  up) . 7% 

2BH  Set  system  date  (Ver.  1  and  up) . 797 

2CH  Get  system  time  (Va.  1  and  up) . 797 

2DH  Set  system  time  (Ver.  1  and  up) . 797 
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DTA 

Function _ Description _ Page  Number 

lAH  Set  DTA  address  (Ver.  1  and  15)) . 788 

2FH  Get  DTA  address  (Vo-.  2  and  up) . 798 


Search  directory 

Function _ Description _ PageNumbg 

1 IH  Search  for  first  matching  directory  FCB 

(Ver.  1  and  up) . 783 

12H  Search  fw  next  matching  directory  FCB 

(VCT.landup) . 783 

4EH  Search  for  first  matching  directory  FCB 

(Vct.  2  and  up) . 826 

4FH  Search  for  next  matching  directory  handle 

(Vo-.  2  and  up) . 827 

File  access  (FCB) 

Function _ Description _ Page  Number 

OFH  Open  file  (FCB)  (Ver.  1  and  up) . 782 

lOH  Qose  file  (FCB)  (Ver.  1  and  up) . 782 

13H  Delete  file  (FCB)  (Vct.  1  and  up) . 784 

14H  Sequential  read  ff’CT)  (Ver.  1  and  up) . 786 

15H  Sequential  write  (FCB)  (Ver.  1  and  up) . 786 

16H  Create  or  truncate  file  (FCB)  (Ver.  1  aid  up) . 786 

17H  Rename  file  (FCB)  (Ver.  1  and  up) . 787 

21H  Random  read  (FCB)  (Ver.  1  and  iqi) . 790 

22H  Random  write  (FCB)  (Ver.  1  and  up) . 791 

23H  Get  file  size  in  record  (FCB)  (Ver.  1  and  up) . 792 

24H  Set  random  record  number  ^er.  1  and  up) . 792 

27H  Random  block  (FCB)  (Ver.  1  and  up) . 794 

28H  Random  block  write  ^CB)  (Ver.  1  and  up) . 795 

29H  Parse  filename  to  FCB  (Ver.  1  and  up) . 795 

File  access  (handle) 

Function  Description _ Page  Number 

3CH  Create  or  truncate  file  (handle)  (Ver.  2  and  up) . 806 

3DH  Open  file  (handle)  (Ver.  2  and  up) . 807 

3EH  Close  file  (handle)  (Ver.  2  and  up) . 808 

3FH  Read  file  or  device  (handle)  (Ver.  2  and  up) . 808 

40H  Write  to  file  or  device  (handle)  (Ver.  2  and  up) . 809 

41H  Delete  file  (handle)  (Vct.  2  and  up) . 810 

42H  Move  file  pointer  (handle)  (Vct.  2  and  up) . 810 

45H  Duplicate  handle  (Ver.  2  and  up) . 820 

46H  Force  duplicate  of  handle  (Ver.  2  and  up) . 820 

5AH  Create  temporary  file  (handle)  (Ver.  3  and  up) . 834 

56H  Rename  file  (handle)  (Ver.  2  and  up) . 828 
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Interrupt  vectors 

Function _ Description _ PageNumbta: 

25H  Set  interrupt  vector  (Ver.  1  and  up) . 793 

35H  Get  inlmiq>t  vector  (Ver.  2  and  up) . 801 

Disk/hard  disk  access 

Eunclion _ Description _ PageNumbCT 

ODH  Disk  reset  (Vct.  1  and  iqj) . 781 

OEH  Set  default  disk  drive  (Ver.  1  and  up) . 781 

19H  Get  default  disk  drive  (Ver.  1  and  up) . 788 

IBH  Get  allocation  information  for  default  drive 

(Vct.  1  andiq>) . 789 

ICH  Get  allocation  information  for  specified  drive 

(Vct.  2  and  up) . 789 

36H  Get  free  disk  space  (Ver.  2  and  up) . 801 

PSP  access 

Function _ Description _ Page  Number 

26H  Create  PSP  (Vct.  1  and  up) . 793 

62H  Get  PSP  address  (Ver.  3  and  up) . 839 

DOS  flag  access 

Function _ Description _ PaeeNumbCT 

2EH  Set  verify  flag  (Ver.  1  and  up) . 798 

33H  Get  <Ctrl><Break>  flag  (sub-fimction  0) . 800 

33H  Set  <CtrlxBteak>  flag  (sub-fimction  1) . 800 

54H  GetvCTifyflag(VCT.2andi^) 

File  information  access 

Function  Description  _ Page  Number 


43H  Get  file  attributes  (sub-function  0)  (Vct.  2  and  up) . 81 1 

43H  Set  file  attributes  (sub-function  1)  (Vct.  2  and  up) . 812 

57H  Get  file  date  and  time  (sub-fimction  0)  (Vct.  2  and  up).829 

S7H  Set  file  date  and  time  (sub-function  1)  (Vct.  2  and  up).  829 

Country-specific  functions 

Function - Description _ PageNumbCT 

38H  Get  country  (Ver.  2  and  up) . 802 

38H  Get  country  (sub-fimction  0)  (Ver.  3  and  up) . 802 

38H  Set  country  (sub-function  1)  (Ver.  3  and  up) . 804 

Other  functions 

Function _ Description _ Page  Number 

30H  Get  MS-DOS  vCTsion  number  (Ver.  2  and  up) . 799 

4BH  Execute  program  (sub-function  0)  (Vct.  2  and  up) . 823 

4BH  Execute  overlay  program  (sub-fimction  3) . 824 

4DH  Get  return  code  (Vct.  2  and  up) . 826 

59H  Get  extended  CTiCTinformatiai  (Ver.  3  and  up) . 831 
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Interrupt  22H  Terminate  address . 841 

Interrupt  23H  <Ctrl><C>  handler  address . 841 

Interrupt  24H  Critical  error  handler  address . 842 

Interrupt  25H  Absolute  disk  read . 843 

Interrupt  26H  Ahsoiute  disk  write . 844 

Interrupt  27H  Terminate  and  stay  resident . 84S 

Interrupt  2FH  Print  spooler 

Function _ Description _ PageNumbCT 

OOH  Get  print  spooler  install  status . 846 

OlH  Send  file  to  print  spooler . 846 

02H  Remove  file  fitom  print  queue . 847 

OSH  Cancel  all  filesl  in  print  queue . 847 

04H  Hold  print  job  for  status  check . 846 

Interrupt  21H  functions — arranged  hy  function  numbers 

Function _ Description _ PaeeNumbCT 

OOH  Program  terminate  (Ver.  1  and  up) . 773 

OlH  Character  input  with  echo  (Ver.  1  and  up) . 774 

02H  Character  output  (Vor.  1  and  up) . 774 

OSH  Auxiliary  input  (Ver.  1  and  up) . 775 

04H  Auxiliary  output  (Vct.  1  and  up) . 775 

05H  Character  ouq>ut  to  printer  (Vct.  1  and  up) . 776 

06H  Direct  character  input/output  (Vct.  1  and  up) . 776 

07H  UnGltered  character  input  without  echo  (Ver.  1  and  up)777 

OSH  CharactCT  input  without  echo  (Ver.  1  and  up) . 778 

09H-  Output  character  string  (Ver.  1  and  up) . 778 

OAH  Buffered  input  (Ver.  1  and  up) . 779 

OBH  Get  input  status  ^er.  1  and  up) . 780 

OCH  Reset  input  buHer  and  then  input  (Ver.  1  and  up) . 780 

ODH  Disk  reset  (Ver.  1  and  up) . 781 

OEH  Set  default  disk  drive  (Ver.  1  and  up) . 781 

OFH  Open  file  (FCB)  (Ver.  1  and  up) . 782 

lOH  Qose  file  (FCB)  (Ver.  1  and  up) . 782 

1 IH  Search  for  first  match  (FCB)  (Vct.  1  and  up) . 783 

12H  Search  for  next  match  (FCB)  (Ver.  1  and  up) . 784 

13H  Delete  file  (FCB)  (Vct.  1  and  up) . 784 

14H  Sequential  read  O^CB)  (Vct.  1  and  up) . 785 

15H  Sequential  write  (FCB)  (Vct.  1  and  up) . 786 

16H  Create  or  truncate  file  (FCB)  (Vct.  1  and  up) . 786 

17H  Rename  file  (FCB)  (Ver.  1  and  up) . 787 

19H  Get  default  disk  drive  (Ver.  1  and  up) . 788 

lAH  Set  DTA  address  (Ver.  1  and  up) . 788 

IBH  Get  allocation  information  for  default  drive 

(Ver.  1  and  up) . 789 

ICH  Get  allocation  information  for  specified  drive 

(Vct.  2  and  up) . 789 

21H  Random  read  (FCB)  (Vct.  1  and  up) . 790 

22H  Random  write  (FCB)  (Vct.  1  and  up) . 791 

23H  Get  file  size  in  record  (FCB)  (Vct.  1  and  up) . 792 
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24H  Set  random  record  number  (Ver.  1  and  up) . 792 

25H  Set  interrupt  vector  (Ver.  1  and  up) . 793 

26H  Create  PSP  (Ver.  1  and  up) . 793 

27H  Random  block  read  (FCB)  (Ver.  1  and  up) . 794 

28H  Random  block  write  (E’CB)  (Ver.  1  and  up) . 79S 

29H  Parse  filename  to  FCB  (Ver.  1  and  up) . 795 

2AH  Get  system  date  (Ver.  1  and  iq)) . 7% 

2BH  Set  system  date  (Ver.  1  and  up) . 797 

2CH  Get  system  time  (Vct.  1  and  up) . 797 

2DH  Set  system  time  (Ver.  1  and  up) . 797 

2EH  Set  voify  flag  (Ver.  1  and  up) . 798 

2FH  Get  DTA  address  (Vo:.  2  and  up) . 798 

30H  Get  MS-DOS  vasioi  number  (Ver.  2  and  up) . 799 

31H  Terminate  and  stay  resident  (Vet.  2  and  up) . 799 

33H  Get  <Ctrl><Breal&  flag  (sub-function  0) 

(Vct.  2  and  n)) . 800 

33H  Set  <Ctrl><Break>  flag  (sub-function  1) 

(Va.  2  and  up) . 800 

35H  Get  interrupt  vectw  (Vo*.  2  and  up) . 801 

36H  Get  free  disk  space  (Ver.  2  and  up) . 801 

38H  Get  country  (Ver.  2  and  up) . 802 

38H  Get  country  (sub-function  0)  (Ver.  3  and  up) . 802 

38H  Set  country  (sub-function  1)  (Ver.  3  and  up) . 804 

39H  Createsubdii^tory  (Va'.2andup) . 804 

3AH  Delete  subdirectory  (Vct.  2  and  up) . 805 

3BH  Set  current  directory  (Ver.  2  and  up) . 805 

3CH  Create  or  truncate  file  (handle)  (Vo'.  2  and  up) . 806 

3DH  Open  file  (handle)  (Ver.  2  and  up) . 807 

3EH  Qose  file  (handle)  (Wet.  2  and  up) . 808 

3FH  Read  file  or  device  (handle)  (Ver.  2  and  up) . 808 

40H  Write  to  file  or  device  (handle)  (Ver.  2  and  up) . 809 

41H  Delete  file  (handle)  (Ver.  2  and  up) . 810 

42H  Move  file  pointer  (handle)  (Vct.  2  and  up) . 810 

43H  Get  file  attributes  (sub-function  0)  (Ver.  2  and  up) . 811 

43H  Set  file  attributes  (sub-function  1)  (Ver.  2  and  iq)) . 812 

44H  lOCIL:  Get  device  info  (sub-function  0) 

(Vct.  2  and  iqr) . 813 

44H  lOCTL:  Set  device  info  (sub-function  1) 

(Ver.  2  and  up) . 813 

44H  lOCTL:  Read  data  from  charact^  device  (sub-function  2) 

(Vw.  2  and  up) . 814 

44H  lOCTL:  Send  data  to  characto'  device  (sub-function  3) 

(Vct.  2  and  up) . 815 

44H  lOCTL:  Read  data  from  block  device  (sub-function  4) 

(Ver.  2  and  up) . 816 

44H  lOCTL:  Send  data  to  block  device  (sub-function  5) 

(Ver.  2  and  up) . 816 

44H  lOCTL:  Read  input  status  (sub-function  6) 

(Ver.  2  and  up) . 817 
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44H  KXJTL:  Read  ou^ut  status  (sub-function  7) 

(Vct.  2  and  i?)) . 817 

44H  KXHL:  Test  for  changeable  block  device 

(sub-function  8)  (Ver.  3  and  tq)) . 818 

44H  lOCIL:  Test  for  local  ot  remote  drive 

(sub-function  9)  (Vct.  3.1  and  up) . 818 

44H  lOCTL;  Test  for  local  or  remote  handle 

(sub-function  10)  (Vct.  3.1  and  up) . 819 

44H  lOCTL:  Change  retry  count  (sub-function  1 1) 

(Vct.  3  and  tp) . 819 

45H  Duplicate  hande  (Ver.  2  and  up) . 820 

46H  Fbrce  duplicate  of  handle  (Vo'.  2  and  up) . 820 

47H  Get  current  directory  (Vo*.  2  and  up) . 821 

48H  Allocate  memory  (Ver.  2  and  up) . 821 

49H  Release  memory  (Ver.  2  and  up) . 822 

4AH  Modify  memory  allocation  (Ver.  2  and  up) . 822 

4BH  Execute  [Hogiam  (sub-function  0)  (Vo'.  2  and  up) . 823 

4BH  Execute  ovo-lay  (sub-function  3)  (Ver.  2  and  up) . 824 

4CH  Terminate  with  return  code  (Ver.  2  and  up) . 825 

4DH  Get  return  code  (Ver.  2  and  IQ)) . 826 

4EH  Search  for  first  match  (Ver.  2  and  up) . 826 

4FH  Search  fOT  next  match  (handle)  (Vo*.  2  and  up) . 827 

54H  Get  verify  flag  (Va.  2  and  up) . 828 

S6H  Rename  file  (handle)  (Ver.  2  and  up) . 828 

57H  Get  file  date  and  time  (sub-function  0)  (Ver.  2  and  up).829 

S7H  Set  file  date  and  time  (sub-function  1)  (Vo*.  2  and  up).  829 

S8H  Get  allocation  strategy  (sub-function  0) 

(Ver.  3  and  up) . 830 

S8H  Set  allocation  strategy  (sub-function  1) 

(Ver.  3  and  up) . 831 

59H  Get  extended  »ror  information  (Vo’.  3  and  IQ)) . 832 

5AH  Create  temporary  file  (handle)  (Ver.  3  and  up) . 834 

5BH  Create  new  file  Randle)  (Vo*.  3  and  up) . 835 

5CH  Control  record  access  (Vct.  3  and  iq)) . 835 

5EH  Get  machine  name  (sub-function  0)  (Ver.  3  and  up)  ....836 

5EH  Set  printer  setup  (sub-function  2)  (Ver.  3  and  up) . 836 

5EH  Get  printer  setup  (sub-functioi  3)  (V».  3  and  up) . 837 

5FH  Get  redirection  list  entry  (sub-function  2) 

(Ver.  3  and  up) . 837 

5FH  Redirect  device  (sub-function  3)  (V».  3  and  up) . 838 

5FH  Cancel  redirection  (sub-function  4)  (Ver.  3  and  up) . 839 

62H  Get  PSP  address  ^er.  3  and  up) . 839 

63H  Get  lead  byte  table  (sub-function  0)  (Ver.  2.25  otdy)...840 

63H  Set  or  clear  intoim  console  flag  (sub-fimctiai  1) 

(Ver.  2.25  only) . 840 

63H  Get  interim  console  flag  (sub-function  2) 

(Ver.  2.25  only) . 840 
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Interrupt  20H  DOS 

Terminate  program  (Version  1  and  up) 

Restores  the  three  interrupt  vectcws  whose  contents  were  stored  in  the  PSP  bef(»e 
the  program  call,  terminates  the  currently  running  {aogram  and  returns  control  to 
MS-DOS.  If  the  program  redirected  the  vecuxs  to  its  own  routine,  these  vectors 
cannot  be  overwritten  by  another  program.  However,  the  terminating  program 
releases  the  RAM  it  had  occupied.  Before  turning  control  over  to  the  calling 
program,  this  memory  releases  and  all  data  buffers  clear. 

Input:  CS  =  Segment  address  of  the  PSP 

Output:  No  output 

Remarks:  COM  programs  automatically  store  the  segment  address  of  the  PSP  in  the 

CS  register.  EXE  programs  require  additional  programming  to  load  the 
segment  athlress  of  the  PSP  into  the  CS  register.  Since  the  code  and  the 
PSP  are  stored  in  two  separate  segments,  the  address  of  the  PSP  must  be 
loaded  into  the  CS  register.  The  code  executes  from  another  segment, 
which  makes  it  impossible  to  call  interrupt  32.  To  help  overcome  this 
problem,  the  value  0  and  then  the  segment  address  of  the  PSP  are  pushed 
onto  the  stack.  If  a  FAR  RETURN  command  thra  executes,  the  program 
execution  continues  in  the  PSP  segment  at  offset  address  0.  There  a  call 
for  intOTupt  terminates  the  program. 

For  the  first  version  of  E>OS,  this  interrupt  is  the  usual  method  for  ending 
a  program.  To  terminate  a  program  in  IK)S  Version  2  and  up,  functions 
31H  or  4CH  of  DOS  intorupt  21  H  should  be  called  instead. 

Interrupt  21H,  function  OOH  DOS 

Terminate  program  (Version  1  and  up) 

Terminates  execution  of  the  currently  running  program  and  returns  control  to  the 
calling  program.  Before  this  happens,  the  three  interrupt  vectors,  whose  contents 
had  been  stored  in  the  PSP  before  the  call  of  the  program,  are  restored.  If  the 
program  redirects  these  vectors  to  its  own  routine,  diey  cannot  be  overwritten  by 
another  program.  However,  the  terminating  program  does  release  the  RAM  it  had 
occupied.  Before  turning  control  over  to  the  calling  program,  the  function  releases 
this  memory  and  clears  all  buffos. 

Input:  AH  =  OOH 

CS  =  segment  address  of  the  PSP 

Output:  No  ouq)ut 

Remarks:  COM  programs  automatically  store,  in  the  CS  register,  the  segment 

address  of  the  PSP.  Since  the  code  and  the  PSP  are  stored  in  two  separate 
segments,  you  caimot  execute  this  function  from  an  EXE  program. 
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Instead  of  this  function,  use  either  function  31H  or  4CH  of  interrupt  21H 
for  terminating  a  program. 

Interrupt  21H,  function  OlH  DOS 

Character  input  with  echo  (Version  1  and  up) 

Reads  a  characte*  from  the  standard  input  device  and  displays  it  on  the  standard 
output  device.  When  the  function  is  called  but  a  character  doesn't  exist,  the 
function  waits  until  a  characte*  is  available.  Since  standard  input  and  output  can  be 
redirected,  this  function  is  able  to  read  a  charact^  from  an  input  device  other  than 
the  keyboard  and  send  it  to  an  output  device  other  than  the  screen.  The  characters 
that  are  read  may  originate  from  other  devices  or  from  a  file.  If  the  character  comes 
from  a  file,  the  input  doesn't  redirect  to  the  keyboard  once  it  reaches  the  end  of  the 
file.  So,  the  function  continues  to  try  to  read  data  from  the  file  after  it  passes  the 
end. 

AH=  OlH 
ALs  Character  read 

If  extended  key  codes  are  read,  the  function  passes  code  0  to  the  AL  regis¬ 
ter.  The  function  must  be  called  again  to  read  the  actual  code. 

If  the  function  encounters  a  <Ctrl><:C>  character  (ASCII  code  3),  it  calls 
interrupt  23H. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  02H  DOS 

Character  output  (Version  1  and  up) 

Displays  a  character  on  the  standard  output  device.  Since  this  device  can  be 
redirected,  the  character  can  be  displayed  on  another  output  device  or  sent  to  a  file. 
This  function  doesn't  test  whether  or  not  the  storage  me^um  (disk  or  hard  disk)  is 
already  full.  Therefore,  it  will  continue  to  try  to  write  characters  to  this  file. 

Input:  AH  =  02H 

DL=  code  of  the  character  to  be  output 

Output:  No  output 

Remaiks:  Control  codes  such  as  backspace,  carriage  return  and  linefeed  are  executed 

when  the  function  sends  chaiacters  to  the  screen.  If  the  output  is  redirected 
to  a  file,  control  codes  are  stored  as  normal  ASCII  codes. 

If  the  function  encounters  a  <Ctrl><C>  character  (ASQI  code  3),  it  calls 
interrupt  23H. 


Input: 

Output: 

Remarks: 
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The  contmts  of  the  pnx^ssor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 

Interrupt  21H,  function  03H  DOS 

Read  character  auxiliary  input  (Version  1  and  up) 

Reads  a  character  from  the  serial  port.  Access  defaults  to  the  device  with  the 
designation  COMl,  unless  a  MODE  command  previously  redirected  soial  access. 

Input:  AH  =  OSH 

Output*  AL=  Character  received 

Remarks:  Since  the  serial  port  has  no  intoiuil  buffo:,  it  can  receive  characters  faster 

than  it  can  read  them.  The  unread  charactos  are  thoi  ignored. 

Before  calling  this  function,  communication  parameters  (baud  rate, 
number  of  stop  bits,  etc.)  must  be  set  using  the  MODE  command. 
Otherwise  DOS  defaults  to  2400  baud,  one  stop  bit,  no  parity  and  a  wwd 
length  of  8  bits. 

The  BIOS  functions  called  from  intorupt  14H  are  a  mcxe  efficioit  way  to 
access  the  serial  port  Since  they  also  allow  reading  of  the  serial  pcvt 
status,  these  functions  offer  m(»e  flexibility  than  the  DOS  functions. 

If  the  function  encounto^  a  <Ctrl><C>  character  (ASCII  code  3),  it  calls 
interrupt  23H. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registns  are  not  affected  by  this  function. 

Interrupt  21H,  function  04H  DOS 

Auxiliary  output  (Version  1  and  up) 

Sends  a  character  to  the  serial  port.  Unless  a  MODE  command  previously 
redirected  soial  access,  access  defaults  to  the  device  with  the  designation  COMl. 

Input:  AH=  04H 

DL=  Character  set  for  output 

OuQ>ut:  No  ouQ>ut 

Remarks:  As  soon  as  the  receiving  device  sends  a  signal  to  the  function  indicating 

that  it  is  ready  to  receive  it,  the  function  transmits  the  character.  Control 
th^  returns  to  the  calling  program. 

Before  calling  this  function,  communication  parameters  (baud  rate, 
number  of  stop  bits,  etc.)  must  be  set  using  the  MODE  command. 
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Otherwise  DOS  defaults  to  2400  baud,  one  stop  bit,  no  parity  and  a  w(xd 
length  of  8  bits. 

The  BIOS  functions  called  from  intorupt  14H  are  a  more  efficioit  way  to 
access  the  serial  port.  Since  they  also  allow  reading  of  the  serial  pmt 
status,  they  offer  more  flexibility  than  the  DOS  functions. 

If  the  function  encount^  a  <Cirl><C>  character  (ASCII  code  3),  it  calls 
interrupt  23H. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 


Interrupt  21H,  4‘anction  OSH 
Character  output  to  printer 


DOS 

(Version  1  and  up) 


Sends  a  characto’  to  the  printer.  Access  defaults  to  the  device  with  the  designation 
LPTl  (identical  to  PP^,  unless  a  MODE  command  previously  redirected  printer 
access.  \ 


Input:  AH  =  OSH 

DL=  Character  code  to  be  printed 

Output:  No  output 

Remarks:  The  function  transmits  the  character  only  when  the  prints  signals  that  it 

is  ready  to  receive  it.  Then  control  returns  to  the  calling  program. 

If  the  function  encount^  a  <CtrlxC>  character  (ASCH  code  3),  it  calls 
interrupt  23H. 

The  BIOS  functions  called  from  interrupt  17H  are  more  efficient  for 
printer  access.  They  offer  more  flexibility  than  the  DOS  printer  functions 
for  character  output 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 

Interrupt  21H,  function  06H  DOS 

Direct  console  I/O  (Version  1  and  up) 

Reads  characters  from  the  standard  input  device  and  displays  them  on  the  standard 
output  device.  The  read  or  written  character  isn't  tested  by  the  operating  system 
(e.g.,  <Ctrl><C>  has  no  effect  on  the  program).  Since  standard  input  and  ouqrut 
can  be  redirected,  this  function  can  read  a  character  from  an  input  device  otha  than 
the  keyboard  and  sends  it  to  an  ou^rut  device  other  than  the  screen.  The  characters 
read  may  originate  from  other  devices  or  from  a  file.  When  writing  charactos,  this 
function  doesn't  test  whether  or  not  the  storage  medium  (disk  or  hard  disk)  is 
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already  full.  Also,  the  calling  program  cannot  detmrnine  whether  all  the  characters 
have  been  read  fixxn  an  iiqnit  file. 

During  character  input,  the  function  doesn't  wait  until  a  character  is  available. 
Instead,  the  function  returns  control  to  the  calling  {Hogram. 

Input:  AH=  ObH 

DL=  0-254:  Send  chaiacto' code 
DL=  2SS:Readacharacta‘ 

OuQ>ut:  Character  output:  No  output 

Characto*  input:  Zoo  fla^l:  No  charact^  ready 
Zero  flag=0:  Charactn  read  is  in  the  AL  registo* 

Remarks:  If  extended  key  codes  are  read,  the  function  passes  code  0  to  the  AL  regis- 

ta.  The  function  must  be  called  again  to  read  the  actual  code. 

ASCn  code  255  (blank)  caimot  be  di^layed  with  this  function  because 
the  function  intoprets  ASQI  code  255  as  a  command  to  input  a  character. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  07H  DOS 

Unfiltered  character  input  without  echo  (Version  1  and  up) 

Reads  a  character  from  the  standard  iiqrut  device  without  displaying  the  chaiacto'  on 
the  standard  ouq>ut  device.  If  a  character  doesn't  exist  when  the  function  is  called, 
the  function  waits  until  a  charact^  is  available.  The  read  character  is  not  tested  by 
the  operating  system  (e.g.,  <Ctrl><C>  has  no  effect  on  the  program).  Since 
standi  input  and  output  can  be  redirected,  this  function  can  read  a  character  finxn 
an  input  device  otha  than  the  keyboard.  Ihe  characters  that  are  read  may  originate 
from  other  devices  or  from  a  file.  If  the  characters  come  from  a  file,  the  input 
doesn't  redirect  to  the  keyboard  once  it  reaches  the  end  of  file.  This  causes  the 
function  to  continue  to  try  reading  data  from  the  file  aft^  it  passes  the  end  of  file. 

Input:  AH=  07H 

Ouq)ut:  AL=  Charactraiead 

Remarks:  If  extended  key  codes  are  read,  the  function  passes  code  0  to  the  AL  regis- 

ta.  The  function  must  be  called  again  to  read  the  actual  code. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 
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Interrupt  21H,  function  OSH  DOS 

Character  input  without  echo  (Version  1  and  up) 

Reads  a  chaiacto’  Ctom  the  standard  input  device  without  displaying  the  chaiacto’  on 
the  standard  output  device.  If  no  character  exists  when  the  function  is  called,  the 
function  waits  until  a  charact^  is  available. 

Since  standard  input  can  be  redirected,  this  function  can  read  a  character  from  an 
input  device  other  than  the  keyboard.  The  characters  read  may  originate  from  other 
devices  or  from  a  file.  If  the  charactos  come  from  a  file,  the  input  doesn't  redirect 
to  the  keyboard  on  reaching  the  end  of  file,  so  the  function  continues  to  try  reading 
data  from  the  file  after  it  passes  the  end  of  file. 

Input:  AH  =  OSH 

Output:  AL=  Qiaract^read 

Remarks:  If  extended  key  codes  are  read,  the  function  passes  code  0  to  the  AL  regis- 

ta.  The  function  must  be  called  again  to  read  the  actual  code. 

If  the  function  encounters  a  <Clrl><C>  character  (ASCII  code  3),  it  calls 
interrupt  23H. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 

Interrupt  21H,  function  09H  DOS 

Output  character  string  (Version  1  and  up) 

Displays  a  characta  string  on  the  standard  output  device.  Since  this  device  can  be 
redirected,  the  character  may  be  displayed  on  another  ouqrut  device  or  sent  to  a  file. 
This  function  doesn't  test  whether  or  not  the  storage  me^um  (disk  or  hard  disk)  is 
already  full,  and  will  continue  to  try  to  write  the  string  to  a  file. 

Input:  AH=  09H 

DS=  String  segment  address 
DX=  String  c^set  address 

Output:  No  output 

Remarks:  The  string  must  be  stored  in  memory  as  a  smes  of  bytes  which  contain 

the  ASCII  codes  of  the  characters  to  be  ouQtuL  A  dollar  sign  character  "$" 
(ASCII  code  36)  indicates,  to  DOS,  the  end  of  the  string. 

Ctntrol  codes,  such  as  backspace,  carriage  return  and  linrieed,  are  executed 
within  the  string. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 
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Interrupt  21H,  function  OAH  DOS 

Buffered  input  (Version  1  and  up) 

Reads  a  number  of  characters  from  the  standard  input  device  and  transmits  the 
charact^  to  a  buffa*.  The  input  rads  when  the  user  presses  the  <Return>  key.  The 
ASCn  code  of  this  key  (13)  is  then  placed  in  the  buffer  as  the  last  character  of  the 
string. 

Since  standard  input  can  be  redirected,  this  function  can  read  a  character  from  an 
input  device  othra  than  the  keyboard.  Hie  charactns  read  may  originate  eithra  from 
odier  devices  or  from  a  file.  If  the  charactras  come  from  a  file,  the  input  doesn't 
redirect  to  the  keyboard  on  reaching  the  rad  of  file,  so  the  function  amtinues  to  try 
reading  data  from  the  file  after  it  passes  the  rad. 

Input:  AH  =  OAH 

DSs  Buffer  segment  address 
DX=  Buffra  offset  address 

Output:  No  ou^ut 

Remarics:  The  first  byte  of  the  buffer  accepts  the  maximum  number  of  charactras 

(including  the  carriage  return  which  ends  the  input)  which  can  be  read  into 
the  buffra,  starting  at  memory  location  2.  In  order  to  infimm  the  fimction 
of  the  maximum  number  of  characters  it  may  read,  this  information  must 
be  entered,  by  the  calling  program,  into  the  buffer  before  the  function 
call. 

After  completion  of  the  input,  DOS  places  the  number  of  characters  read 
(excluding  the  carriage  return)  in  memory  location  1. 

The  buffer  must  be  the  number  of  the  characters  to  be  read  plus  2  bytes. 

When  the  input  reaches  the  second  to  last  memory  location  in  the  buffra, 
the  computer  beeps  if  you  attempt  to  enter  any  character  other  than  the 
<Return>  key  (end  of  input). 

Extended  key  codes  occupy  two  bytes  in  the  buffer.  The  first  byte 
contains  the  code  0,  and  the  second  byte  contains  the  extended  key  code. 

If  the  function  encounters  a  <Ctrl><C>  character  (ASCH  code  3),  it  calls 
interrupt  23H. 

The  <Backspace>  and  cursor  keys  let  you  edit  the  input  without  storing 
these  keys  in  the  buffer. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 
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Interrupt  21H,  function  OBH  DOS 

Get  input  status  (Version  1  and  up) 

Determines  whether  a  character  is  available  for  reading  from  the  standard  input 
device. 


Input:  AH=  OBH 

Output:  AL  =  0:  No  character  available 

AL  =  2SS:  One  or  more  characters  available  for  reading 

Remarks:  If  the  function  encount^  a  <CtrlxC>  character  (ASCII  code  3),  it  calls 

interrupt  23H. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  OCH  DOS 

Reset  input  buffer  and  then  input  (Version  1  and  up) 

Clears  the  input  buffer  then  calls  one  of  the  character  input  functions.  Since  all  the 
character  input  functions  get  their  characters  from  the  standard  input  device  and 
standard  input  may  redirected,  this  function  only  operates  when  the  keyboard  is  the 
standard  input  device.  In  this  case  the  characters  could  be  entered  before  the 
function  call  but  not  read  by  a  function.  These  existing  charact^s  are  erased  to 
ensure  that  the  function  call  only  reads  charactras  which  were  inputted  after  its  call. 

Input:  AH=  OCH 

AL  =  Function  to  be  called  during  call  of  function  10 
DS  =  Input  buffer  segment  address 
DX=  Input  buffer  offset  address 

Output:  Functions  1 , 6, 7  and  8:  AL  =  Character  to  be  read 

Function  10:  No  ouQ)ut 

Remarks:  Functions  1, 6, 7, 8  and  10  can  be  passed  to  the  function  as  calling  func¬ 

tions. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registo's  are  not  affected  by  this  function. 
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Sends  all  data  stored  in  an  intmial  DOS  buffer  to  a  block  driver  device  (e.g.,  disk 
drive,  hard  disk).  The  opoi  files  (handles  or  FCBs)  remain  (q)en. 

Input:  AH=  ODH 

Output:  No  ouq>ut 

Remarks:  Despite  this  function  call,  all  open  files  must  be  closed  in  an  orderly 

manner.  Otherwise  the  current  directory  entry  of  the  file  may  not  update 
propa-ly,  which  prevoits  access  to  new  file  dt^ 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 

Interrupt  21H,  function  OEH  DOS 

Select  default  disk  drive  (Version  1  and  up) 

Defines  the  the  current  default  disk  drive.  Its  designation  tgtpears  as  a  prompt  on 
the  screen  when  the  command  interpreter  expects  input  from  the  uso'.  The  drive 
indicated  here  will  be  used  for  all  file  access  in  which  no  special  device  was 
specified. 

Input:  AH=  OEH 

DL=  Drive  numba 

OuQtut:  AL=  Number  of  installetf^ves  or  volumes 

Remarks:  Drive  A:  has  code  number  of  0,  drive  B:  code  numbo'  1,  etc. 

Even  if  the  PC  has  only  one  disk  drive  and  one  hard  disk,  the  number  of 
volumes  in  the  AL  registtf  can  be  greater  than  two  because  the  hard  disk 
can  be  divided  into  multiple  volumes.  In  addition,  the  PC  can  have  one  or 
more  RAM  disks  as  part  of  its  configuration.  For  a  PC  with  a  single  disk 
drive,  you  can  only  have  two  volumes  because  drive  A:  also  simulates 
drive  B:. 

Unlike  DOS  Version  2,  which  pomits  63  different  device  codes,  DOS 
Version  3  permits  26  different  devices  (the  letters  A  to  Z).  To  keep 
compatibility  between  visions,  limit  your  device  access  to  a  maximum 
of  26  devices. 

BIOS  intmupt  IlH  does  a  better  job  of  reading  the  number  of  disk  drives 
than  this  funcdon. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 


Interrupt  21H,  function  ODH 
Disk  reset 
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Interrupt  21H,  function  OFH  DOS 

Open  file  (FCB)  (Version  1  and  up) 

C^ns  a  file  if  one  is  available.  Aftn*  this  function  call  executes  successfully,  the 
file  can  be  read  (h*  writtea 

Input:  AH  =  OFH 

DSs  FCB  segmoit  address  of  the  file 
DX=  FCB  c^set  address  of  the  file 

OuQiut:  AL  s  0:  File  found  and  opened 

AL  =  255:  File  not  found 

Remarks:  Both  normal  and  extended  FCBs  can  be  used. 

If  the  file  was  found,  DOS  ento^,  into  the  FCB,  the  file  size,  the  date  and 
the  time  of  its  creation  or  last  modification. 

DOS  sets  the  record  length  at  128  bytes.  This  record  length  can  be 
changed  in  the  FCB  before  opening  a  file.  If  you  need  a  longer  record 
length,  the  DTA  must  be  moved  (the  original  DTA  is  only  128  bytes 
long). 

If  random  file  access  is  performed,  the  random  record  field  in  the  FCB 
must  be  set  after  the  file  opens  successfully. 

The  file  pointer  points  to  the  first  byte  of  the  file  afto’  the  file  opens. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  lOH  DOS 

Close  file  (Ff^B)  (Version  1  and  up) 

Writes  all  data  currently  in  the  DOS  buffer  to  the  file  and  closes  the  file.  In 
addition,  the  directory  entry  changes  to  reflect  the  new  file  size  and  the  date  and 
time  of  the  most  recent  mo^cadon  to  the  file. 

Input:  AH=  lOH 

DS  =  FCB  segment  address  of  the  file 
DX=  FCB  offset  address  of  the  file 

Output:  AL  =  0:  File  closed  and  directory  oitry  revised 

AL  =  255:  File  not  found  in  directory 

Remadcs:  Only  open  files  can  be  closed. 

For  disk  files,  the  disk  which  was  in  the  drive  when  the  function  call 
occurred  must  also  be  the  disk  that  contains  the  file.  Otherwise,  the 
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function  call  writes  an  incorrect  FAT  and  an  inctnrect  directory  to  the 
disk,  which  makes  the  data  that  is  already  (mi  the  disk  useless. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist»s  are  not  affected  by  this  function. 

Interrupt  21H,  function  IIH  DOS 

Search  for  first  match  (FCB)  (Version  1  and  up) 

Searches  for  the  first  occurrence  in  the  disk  directory  of  the  filename  indicated  in 
the  FCB. 

Input:  AH=  IIH 

DS  =  FCB  segment  address 

DX=  FCB  offset  address 

Output:  AL  =  0:  File  found 

AL  =  255:  File  not  found 

Remarks:  The  FCB  passed  to  the  function  contains  the  drive  specifier  and  the 

filename  fw  which  the  function  should  search. 

The  filename  can  contain  the  wildcard "?”  to  search  for  a  group  of  files. 

The  search  is  made  only  in  the  current  directory  of  the  indicated  device. 

If  the  function  searches  for  a  normal  file,  a  normal  FCB  can  pass  the 
information  to  the  function.  However,  if  you  wish  to  search  for  a  file 
with  special  attributes  (volume  name,  subdirectories,  hidden  files,  etc.), 
extended  FCBs  must  be  used. 

If  a  file  was  found,  the  DTA  contains  an  FCB  of  the  same  type  as  the 
FCBs.  This  FCB  in  the  DTA  contains  the  found  filename.  For  this 
reason,  the  DTA  must  always  be  large  enough  to  accept  either  a  normal 
or  an  extended  FCB. 

The  DTA  can  be  switched  to  its  own  buffer  using  function  lAH,  to 
ensure  that  it  is  large  enough  to  accept  the  FCB. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 
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Interrupt  21H,  function  12H  DOS 

Search  for  next  match  (FCB)  (Version  1  and  up) 

Searches  fcx  additional  occuirraces  in  the  disk  directory  of  the  filename  indicated  in 
the  FCB,  after  the  file  was  found  by  function  17  (see  sAwve). 

Input  AH=  12H 

DS=  FCB  segment  address 
DX=  FCB  offset  address 

Output  AL  =  0:  File  found 

AL  =  2S5;  File  not  found  (no  oth^  files  available) 

Remarks:  This  function  can  only  be  called  after  calling  function  1 IH. 

The  FCB  passed  to  the  function  contains  the  drive  specifier  and  the 
filename  for  which  the  function  should  search. 

If  another  ,  filename  was  found  its  name  is  recorded  in  the  FCB  at  the 
beginning  of  the  DTA. 

The  DTA  can  be  switched  with  function  lAH  to  its  own  bufi^  to  ensure 
that  it  is  large  enough  to  accept  the  FCB. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP.  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 

Interrupt  21H,  function  13H  DOS 

Delete  file  (FCB)  (Version  1  and  up) 

Bases  one  or  mwe  files  in  the  current  directory  of  the  specified  device. 

Input:  AH=  13H 

DS=  FCB  segment  address 
DX=  FCB  (^fset  address 

Output:  AL  =  0:  file(s)  erased 

AL  =  255:  No  file(s)  found,  or  file(s)  assigned  Read  Only  attribute  (undeletable) 

Remarks:  The  FCB  passed  to  the  function  contains  both  the  device  on  which  the 

files  to  be  oased  are  located  and  the  name  of  the  file. 

The  filename  can  contain  the  wildcard "?"  to  oase  a  group  of  files. 

Only  files  in  the  current  directory  of  the  indicated  device  may  be  erased. 

If  the  function  is  used  to  delete  a  ntnmal  file,  a  normal  FCB  can  pass  the 
information  to  the  function.  However,  if  you  want  to  delete  a  file  with 
special  attributes  (volume  name,  subdirectories,  hidden  files,  etc.), 
extended  FCBs  must  be  used. 
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Volumes  may  be  deleted  with  this  function;  subdirectories  may  not 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  14H 
Sequential  read  (FCB) 

Reads  the  next  sequential  data  block  firom  a  file. 

Input:  AH=  14H 

DS=  FCB  segment  address 
DX=  FCB  offset  address 

Ouq>ut:  AL=  0:  Block  read 

AL=  1:  End  of  file  reached 
AL  =  2:  Segment  wrtq) 

AL=  3:  Partial  reoxd  read 

Remarks:  The  function  can  only  be  called  after  the  file  was  opened  by  the  indicated 

FCB. 

The  DTA  reads  the  block.  If  the  DTA  is  not  large  enough,  function  lAH 
must  move  the  DTA  into  its  own  buffo*. 

The  FCB  records  the  size  of  the  block  and  the  corresponding  number  of 
bytes  read. 

Erro'  2  occurs  when  the  DTA  teaches  the  end  of  a  segment  and  the  block 
being  read  extends  beyond  the  end  of  the  segment 

Error  3  occurs  when  a  partial  block  tq)pears  at  the  end  of  the  file.  The 
block  is  read  in  anyway  and  blank  spaces  bring  the  block  up  to  the 
allocated  block  size. 

After  reading  a  block,  the  file  pointer  resets  to  the  beginning  of  the  next 
block  so  that  the  next  function  call  automatically  reads  the  next  block. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 
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Interrupt  21H,  function  15H 
Sequential  write  (FCB) 

Writes  a  sequential  block  to  a  file. 

Input:  AH=  15H 

DS=  FCB  segment  address 
DX=  FCB  offset  address 

Ouq)ut:  AL=  0:  Block  written 

AL  =  1:  Medium  (disk/hard  disk)  full 
AL=  2:  Segment  oveiflow 

Remaiks:  The  function  can  only  be  called  after  the  file  was  opened  by  the  indicated 

FCB. 

The  DTA  writes  the  block  it  contains  to  the  file.  If  the  DTA  is  not  large 
enough  to  hold  the  file,  function  lAH  must  be  used  to  move  the  DTA 
into  its  own  buffer. 

The  FCB  records  the  size  of  the  block  and  the  corresponding  number  of 
bytes  written. 

Error  2  occurs  if  the  DTA  reaches  the  end  of  a  segment  and  the  block 
being  written  extends  beyond  the  end  of  the  segment 

After  writing  a  block,  the  file  pointer  resets  to  the  beginning  of  the  next 
block,  so  that  the  next  function  call  automatically  writes  the  next  block. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  16H  DOS 

Create  or  truncate  file  (FCB)  (Version  1  and  up) 

Creates  a  new  file,  or  dumps  the  contents  of  an  existing  file  (file  size=0  bytes). 
This  function  call  allows  other  functions  to  read  or  write  to  the  open  file. 

Input:  AH=  16H 

DS=  FCB  segment  address 
DX=  FCB  offset  address 

Output:  AL  =  0:  File  created  or  cleared 

AL  =  255:  File  could  not  be  created  (e.g.,  directory  full) 

Remarks:  The  contents  of  an  existing  file  called  by  this  function  are  lost. 

After  calling  this  function,  the  file  is  already  open;  you  don't  need  to  open 
the  file  using  function  OFH  (see  above). 
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If  you  open  the  file  using  an  extended  FCB,  you  can  assign  certain 
attributes  to  the  file  (e.g.,  volume  name,  hidden  file,  etc.). 

You  cannot  create  a  subdirectcny  using  this  fiinctiai. 

After  (q)ening  the  file,  die  file  pointer  moves  to  the  first  byte  of  the  file. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  17H  DOS 

Rename  file  (FCB)  (Version  1  and  up) 

Renames  one  or  more  files  in  the  current  directwy  of  the  specified  device. 

Input:  AH=  17H 

DS=  FCB  segment  address 
DX=  FCB  (tffset  address 

Ouqiut:  AL  =  0:  Hle(s)  renamed 

AL=  2SS:  No  file  found,  or  new  filraame  matches  old  filename 

Remarks:  The  FCB  here  is  a  special  FCB,  based  on  a  nmmal  FCB.  The  first  12 

bytes  contain  the  drive  specifier  and  the  name  of  the  file  to  be  renamed. 
However,  this  type  of  FCB  has  the  new  drive  specifier  and  the  new 
filename  sbwed  starting  at  memmy  location  lOH.  The  ^ve  specifier  must 
be  identical  for  both  filenames. 

The  name  of  the  file  to  be  renamed  can  contain  the  wildcard  ”?”,  which 
renames  several  files.  If  the  new  filename  contains  the  wildcard "?",  the 
places  in  the  filename  and  extension  who'e  a  question  mark  appears  in 
this  parameto'  remain  unchanged. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registo^  are  not  affected  by  this  function. 
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Interrupt  21H,  function  19H 
Get  default  disk  drive 

Returns  the  drive  specifier  of  the  default  (currrat)  disk  drive. 

Input:  AH=  19H 

Output:  AL=  Drive  specific 

Remarks:  This  function  identifies  drive  A  as  code  0,  drive  B  as  code  1,  etc. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  lAH  DOS 

Set  DTA  address  (Version  1  and  up) 

Transfers  the  DTA  (Disk  Transfer  Area)  to  another  area  of  memory.  The  DTA  acts 
as  buffa*  memory  for  all  FCB  supported  file  accesses. 

Input:  AH=  lAH 

DS  =  New  DTA  segment  address 
DX=  New  DTA  offset  address 

Output:  No  output 

Remarks:  This  function  must  be  called  if  the  existing  DTA  has  insufficient  memory 

to  handle  the  transmitted  data 

When  the  program  starts,  MS-DOS  places  the  DTA  at  address  128  in  the 
PSP.  Since  the  program  starts  after  address  255  of  the  PSP,  it  is  128 
bytes  long. 

DOS  does  not  test  the  length  of  the  DTA.  Instead  it  assumes  that  the 
DTA  is  large  enough  to  accq>t  the  transmitted  data.  If  this  is  not  the  case, 
a  DOS  function  can  overwrite  the  excess  data. 

DOS  recognizes  an  mor  during  various  functions  if  the  DTA  is  at  the  end 
of  a  segment  and  the  data  to  be  transmitted  exceeds  the  end  of  the 
segment. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  flmction. 
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Interrupt  21H,  function  IBH  DOS 

Get  allocation  information  for  default  drive  (Version  1  and  up) 


Returns  iiif(»ination  about  the  fcMuiat  of  the  default  drive. 


Input; 

Ouq[>ut: 


Remarks: 


AH=  IBH 

AL=  Numba  of  sectcHS  clustn^ 

DS=  Media  descr^tor  segment  address 
BX=  Media  descr^rtor  offset  address 
DX=  Number  of  clustra^ 

The  media  descriptor  can  return  the  following  codes: 

F8H:  Harddisk 

F9H:  Disk  drive:  double-sided,  15  sectors  per  track  (AT  only) 

FCH:  Disk  drive:  single-sided,  9  sectors  pa  track 

FDH:  Disk  drive:  double-sided,  9  sectcHS  pa  track 

FEH:  Disk  drive:  single-sided,  8  sectors  pa  track 

FFH:  Disk  drive:  double-sided,  8  sectors  pa  track 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist»s  are  not  affected  by  this  function. 


Interrupt  21H,  function  ICH  DOS 

Get  allocation  information  for  speciffed  drive  (Version  1  and  up) 

Returns  information  about  the  format  of  the  specified  drive. 

Input;  AH=  ICH 

DL=  Drive  specific 

Output:  AL=  Numbo' of  sectors  p»  clust^ 

DS=  Media  descr^tor  segment  address 
BX=  Media  descr^ytortrf!^  address 
DX=  Number  of  clustos 

Remarks:  This  function  identifies  drive  A  as  code  0,  drive  B  as  code  1,  etc. 

The  media  descriptts*  can  return  the  following  codes; 

F8H:  Harddisk 

F9H;  Disk  drive:  double-sided,  15  sectors  pa  track  (AT  only) 
FCH:  Disk  drive:  single-sided,  9  sectors  pa  track 

FDH:  Disk  drive:  double-sided,  9  sectors  po*  track 

FEH:  Disk  drive:  single-sided,  8  sectors  pa  track 

FFH:  Disk  drive;  double-sided,  8  sectors  pa  back 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 
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Interrupt  21(h),  function  IDH 
Reserved 

Interrupt  21(h),  function  lEH 
Reserved 

Interrupt  21(h),  function  IFH 
Reserved 

Interrupt  21(h),  function  20H 
Reserved 

Interrupt  21H,  function  21H 
Random  read  (FCB) 

Reads  a  specified  file  recwd  into  the  DTA. 


DOS 

(Version  1  and  up) 
DOS 

(Version  1  and  up) 
DOS 

(Version  1  and  up) 
DOS 

(Version  1  and  up) 
DOS 

(Version  1  and  up) 


Input: 

AH=  21H 

DS=  FCB  segment  address 
DX=  FCB  offset  address 

Output: 

AL=  0:Recordread 

AL=  1:  End  of  file  reached 
AL  =  2:  Segment  overflow 
AL=  3:  Partial  record  read 

Remarks:  The  function  can  only  be  called  after  the  file  was  opened  by  the  indicated 

FCB. 


The  record  whose  address  is  stored  in  the  FCB  starting  at  location  21H  is 
lead. 


The  DTA  reads  the  record.  If  the  DTA  is  not  large  enough,  function  1  AH 
must  be  called  to  move  the  DTA  into  its  own  buffer. 

The  FCB  records  the  size  of  the  record  and  the  corresponding  number  of 
bytes  read. 

During  the  function  call,  the  file  pointer  moves  to  the  beginning  of  the 
record  being  read  so  that  a  subsequent  call  of  a  sequential  read  (function 
14H — ^see  above)  reads  the  same  record  sequentially. 

The  record  number  does  not  increment  following  the  function  call,  so  a 
new  call  of  this  function  would  read  the  same  record. 

Error  2  occurs  when  the  DTA  reaches  the  end  of  a  segment  and  the  record 
being  read  extends  beyond  the  end  of  the  segment 
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Error  3  occurs  when  a  partial  record  appears  at  the  end  of  the  file.  The 
record  is  read  in  anyway  and  blank  spaces  bring  the  record  up  to  the 
allocated  record  size. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  22H 
Random  write  (FCB) 

Writes  data  from  memory  to  the  specified  record  in  a  file. 

Input:  AH=  22H 

DS  =  FCB  segment  address 

DX=  FCB  offset  address 

Output:  AL=  0:  record  was  written 

AL  =  1:  Medium  (disk/hard  disk)  full 

AL  =  2:  segment  overflow 

Remarks:  The  function  can  only  be  called  after  the  file  was  opened  by  the  indicated 

FCB. 

The  record  whose  address  is  stored  in  the  FCB  starting  at  location  21H  is 
read 

The  record  is  written  from  the  DTA  to  the  file.  If  the  DTA  is  not  large 
enough,  function  1  AH  must  move  the  DTA  into  its  own  buffer. 

The  FCB  records  the  size  of  the  record  and  the  number  of  bytes  read. 

During  the  function  call,  the  file  pointer  moves  to  the  beginning  of  the 
record  being  read.  This  instructs  subsequent  calls  of  a  sequential  read 
(function  14H — ^see  above)  to  read  the  same  record  sequentially. 

The  record  number  does  not  increment  following  the  function  call,  so  a 
new  call  of  this  function  would  read  the  same  record. 

Error  2  occurs  when  the  DTA  reaches  the  end  of  a  segment  and  the  record 
being  written  extends  beyond  the  end  of  the  segment 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 
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Interrupt  21H,  function  23H  DOS 

Get  flle  size  in  records  (FCB)  (Version  1  and  up) 

Detennines  the  size  of  a  file  based  (Hi  the  numbo*  of  reonds  in  that  file. 


AH=  23H 

DS=  FCB  segment  address 
DX=  FCB  offset  address 

AL  =  0:  Numba  of  rectnds  found  starting  at  FCB  address  21H 
AL  =  255:  File  not  found 

The  FCB  passed  contains  the  drive  specifier  as  well  as  the  name  and 
extension  of  the  file  to  be  examined. 

Unlike  the  other  FCB  supported  file  accesses,  the  FCB  requires  the  record 
size  before  the  {plication  can  call  this  function. 

A  record  size  of  1  returns  the  size  of  the  file  in  bytes. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  24H  DOS 

Set  random  record  number  (Version  1  and  up) 

Sets  the  record  number  in  the  FCB  to  the  current  position  of  the  file  pointer. 
Rand(Hn  access  may  begin  at  the  point  at  which  earlier  sequential  accesses  left  off. 

Input:  AH=  24H 

DS=  FCB  segment  address 
DX=  FCB  offset  address 

Ouqiut:  No  ouqiut 

Remarks:  The  function  can  only  be  called  after  the  file  was  opened  by  the  indicated 

FCB. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 


Input* 

Output 

Remarks: 
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Interrupt  21H,  function  25H 
Set  interrupt  vector 

Sets  any  interrupt  vecuv  to  another  routine. 

Input:  AH=  25H 

AL=  Intanipt  numbo’ 

DSs  New  intemq)t  routine  segment  address 
DX=  New  intmupt  routine  offset  address 

OuQ>uL*  No  ou4>ut 

Remarks:  Befcse  calling  this  function,  the  old  contorts  of  the  interrupt  vector  to  be 

changed  should  be  read  and  stcxed  using  function  3SH.  Afta  the  program 
terminates,  the  old  contents  of  the  intorupt  vector  should  be  resttued. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 

Interrupt  21H,  function  26H  DOS 

Create  PSP  (Version  1  and  up) 

Copies  the  PSP  (program  segmoit  prefix)  of  the  executing  program  to  a  specified 
address  in  memory. 

Input:  AH=  26H 

DX=  New  PSP  segmmt  address 

Output:  No  output 

Remarks:  The  new  PSP  (rffset  address  is  0. 

DOS  Version  1  uses  this  function  to  execute  oth»  programs  by  creating  a 
PSP,  loading  the  program  after  this  PSP  and  executing  it. 

For  DOS  VersicHi  2  up,  use  the  EXEC  function  4BH  to  load  and  execute 
additional  programs  instead  of  this  function. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  fimction. 
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Interrupt  21H,  function  27H 
Random  block  read  (FCB) 

Reads  one  or  more  sequentially  stored  records  into  memory. 

Input:  AH=  27H 

CX=  Numba  of  records  to  be  read 
DS=  FCB  segmoit  address 
DX=  FCB  (^set  address 

Output:  AL=  (hRecordiead 

AL=  1:  End  of  file  reached 
AL=  2:  Segmoitovoilow 
AL=  3:  Partial  record  read 
CX=  Numbo’ of  records  read 

Remarks:  The  function  can  only  be  called  after  the  file  was  opened  by  the  indicated 

FCB. 

The  starting  record  is  the  record  whose  address  is  stored  in  the  FCB, 
starting  at  location  21H. 

The  record  data  passes  to  the  DTA.  If  the  DTA  is  not  large  enough, 
function  lAH  must  move  the  DTA  into  its  own  buffer. 

The  FCB  records  the  size  of  the  record  and  the  corresponding  number  of 
bytes  read. 

Afto'  the  function  call,  the  file  pointer  moves  to  the  end  of  the  last  record 
that  was  read  so  that  it  points  to  the  next  record  (following  the  last  record 
read). 

Error  2  occurs  when  the  DTA  reaches  the  end  of  a  segment  and  the  record 
being  read  extmds  beyrnid  the  end  of  the  segment 

Error  3  occurs  when  a  partial  record  spears  at  the  end  of  the  file.  The 
record  is  read  in  anyway  and  blank  spaces  luing  the  record  up  to  the 
allocated  record  size. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 
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Interrupt  21H,  function  28H 
Random  block  write  (FCB) 

Writes  one  w  moie  records  in  sequence  to  the  qjecified  file. 

Input:  AH»  28H 

CX=  Numbo' of  records  to  be  written 

DS=  FCB  segment  address 

DX=  FCB  offset  address 

Output:  AL=  0:  Record  written 

AL  =  1:  Medium  (diricAuud  diric)  full 

AL=  2:  Segment  overflow 

CX=  Numbo’ of  rectnds  written 

Remarks:  The  function  can  only  be  called  after  the  file  was  (q)aied  by  the  indicated 

FCB. 

The  starting  record  is  the  recmd  whose  address  is  stored  in  the  FCB 
starting  at  location  21H. 

The  FCB  records  the  size  of  the  record  and  the  corresponding  number  of 
bytes  read. 

The  data  is  written  from  the  DTA  to  the  file.  If  the  DTA  is  not  large 
enough,  function  lAH  must  move  the  DTA  into  its  own  buffer. 

After  the  function  call,  the  file  pointer  moves  to  the  end  of  the  last  record 
written  so  that  it  points  to  the  next  record,  which  follows  the  last  record 
written.  The  recwd  number  increments  by  the  numb^  of  records  written. 

Error  2  occurs  when  the  DTA  reaches  the  end  of  a  segment  and  the  record 
being  written  extends  beyond  the  end  of  the  segment 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registo^  are  not  affected  by  this  function. 

Interrupt  21H,  function  29H  DOS 

Parse  filename  to  FCB  (Version  1  and  up) 

Transfix  an  ASCII  format  fil^uime  into  the  {wopor  fields  of  an  FCB.  The  filename 
can  include  a  drive  specific,  filename  and  file  extension. 

Input:  AH=  29H 

DS=  Segmrat  address  of  filename  in  memory 
SI  =  Offset  address  of  filename  in  memory 
ES=  FCB  segment  address 
DI  =  FCB  offset  address 


DOS 

(Version  1  and  up) 
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ALs  Transmission  parameto^: 

Bitl=  1:  The  drive  specific' in  the  FCB  changes  only  if  the  filoiame 
passed  contains  a  drive  specific' 

0:  The  drive  specifio*  changes  anyway.  If  the  filename  passed 
contains  no  drive  specifier,  the  the  FCB  defaults  to  0 
(cunm  drive) 

Bit  2=  1:  The  filename  in  the  FCB  changes  only  if  the  filename 
parameto*  passed  contains  a  filename 
0:  The  filename  changes.  If  the  filoiame  passed  does  not  con¬ 
tain  a  filename,  the  filename  in  the  FCB  fills  with  spaces 
(ASCncode32) 

Bit  3=  1:  The  file  extension  in  FCB  changes  only  if  the  filename 
passed  contains  an  extension 

0:  The  file  extension  in  the  FCB  changes.  If  the  filename 
passed  has  no  extension,  the  extension  field  is  padded  with 
spaces  (ASCn  code  32) 

Bits  4-8:  Should  contain  the  value  0 

OuQ)ut:  ALs  0:  Hie  filename  passed  coitains  no  wildcards 

AL=  1:  The  fil^iame  passed  contains  wildcards 
AL=  2SS:  Invalid  drive  specifier 

DS  =  Segment  address  of  the  first  characto’  aft^  parsed  filename 
SI=  Offset  address  of  the  first  characto' after  parsed  filename 
ES  =  FCB  segment  address 
DI  =  FCB  offset  address 

Remarks:  The  filename  must  end  with  an  end  character  (ASCII  code  0). 

If  the  filename  contains  the  wildcard  all  corresponding  fields  in  the 
FCB  fill  with  the  wildcard  "?". 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 

Interrupt  21H,  function  2AH 
Get  system  date 

Reads  the  current  system  date. 

Input:  AH  =  2AH 

Output:  AL  =  Day  of  the  wedc  ((Sunday,  l=Monday,  etc.) 

CX=  Year 
DH=  Month 
DL=  Day 

Remarks:  DOS  calls  the  clock  driver  to  read  the  date. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 


DOS 
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Interrupt  21H,  function  2BH  DOS 

Set  system  date  (Version  1  and  up) 

Sets  the  current  system  date  as  returned  by  function  2AH  (see  above). 

Input:  AH=  2BH 

CX=  Year 
DH=  Month 
DL=  Day 

Output:  AL=  0:  O.K. 

AL=  2SS:  Dale  incorrect 

Rmarks:  The  date  passes  to  the  clock  driva. 

If  the  PC  does  not  have  a  realtime  clock,  the  date  remains  in  effect  until 
the  PC  is  switched  off  or  rebooted. 

If  the  date  entry  is  incorrect,  the  PC  retains  the  old  date. 

^  The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 

the  flag  registns  are  not  affected  by  this  function. 

Interrupt  21H,  function  2CH 
Get  system  time 

Gets  the  current  system  time. 

Input  AH=  2CH 

Output  CH  =  Hours 

CL=  Minutes 
DH=  Secrmds 

DL=  Hundredths  of  a  second 

Rmarks:  DOS  calls  the  clock  drivo-  to  read  the  time. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  2DH  DOS 

Set  system  time  (Version  1  and  up) 

Sets  the  current  system  time. 

Input*  AH  =  2DH 

CH=  Hoi^ 

CL=  Minutes 
DH=  Seconds 
DL=  hundredths  of  a  second 


DOS 
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Output:  AL=  0:  O.K. 

AL=  2SS:  Incorrect  time 

Remarks:  The  time  passes  to  the  ckx:k  drivo'. 

If  the  PC  does  not  have  a  realtime  clock,  the  time  remains  in  effect  until 
the  PC  is  switched  off  or  rebooted. 

If  the  time  entry  is  incorrect,  the  PC  retains  the  old  time. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  2EH  DOS 

Set  verify  flag  (Version  1  and  up) 

Sets  the  vo-ify  flag.  This  flag  determines  whether  data  should  be  verified  after  a 
write  operation  to  a  block  drivo-  for  prop^  transmission. 

Input:  AH=  2EH 

DL=  0 

AL=  0:  Don't  verify  data 
AL=  l:VCTifydata 

Output:  No  ouQrut 

Remarks:  This  flag  can  be  controlled  at  the  user  level  with  the  VERIFY  ON  and 

VERIFY  OFF  commands. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 

Interrupt  21H,  function  2FH  DOS 

Get  DTA  address  (Version  2  and  up) 

Returns  the  address  of  the  DTA  (Data  Transmission  Area),  which  serves  as  a  data 
buffer  fn*  all  FCB  suppwted  flle  accesses. 

Input:  AH=  2FH 

Output:  ES  =  DTA  segment  address 

BX=  DTA  offset  address 

Remarks:  This  function  determines  the  address  of  the  DTA,  but  not  the  DTA's  size. 

kfvst  the  start  of  a  program,  the  DTA  starts  at  memory  location  128  of 
the  PSP  and  has  a  length  of  128  bytes. 

The  contents  of  the  AH,  BX,  CX,  DX.  SI.  DI,  BP,  CS.  DS.  SS.  ES  and 
the  flag  registers  are  not  affected  by  this  function. 
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Interrupt  21H,  function  30H  DOS 

Get  MS-DOS  version  number  (Version  2  and  up) 

Returns  the  DOS  version  number. 


AH=  30H 

AL  =  Major  version  number  (e.g.,  version  2.01=2) 

AH  =  Minor  version  numb^  (e.g.,  version  3.01=01) 

The  major  (whole)  version  number  represents  the  number  preceding  the 
decimal  point.  For  example,  the  version  number  3.3  returns  the  major 
version  number  3. 

The  minor  (fractional)  version  number  represents  the  number  following 
the  decimal  point.  It  is  always  given  as  two  digits.  For  example.  Version 
2.1  returns  the  minor  version  number  10  (OAH). 

If  the  AL  register  contains  a  value  of  0,  the  program  runs  under  DOS 
Version  1.  DOS  Version  1.0  cannot  use  this  function. 

The  contents  of  the  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and  the  flag 
registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  31H  DOS 

Terminate  and  stay  resident  (Version  2  and  up) 

Terminates  the  currently  executing  program  and  returns  control  to  the  calling 
program.  The  current  program  remains  in  memory  for  later  recall. 

Input:  AH=  31H 

AL  =  Return  code 

DX=  Number  of  paragr^hs  to  be  reserved 
Output:  No  output 

Remaiks:  The  return  code  in  the  AL  register  indicates  whether  or  not  the  program 

called  by  it  correctly  executes.  The  calling  program  can  read  this  number 
by  calling  function  77  (4DH).  This  value  can  be  tested  from  within  a 
batch  file  using  the  ERRORLEVEL  and  IF  commands. 

The  number  of  16-byte  paragraphs  to  be  reserved  indicates  how  many 
bytes,  beginning  with  the  PSP,  cannot  be  released  for  other  uses. 

Memory  blocks  reserved  by  function  48H  are  not  affected  by  the  value  in 
the  DX  register  because  they  can  only  be  released  by  calling  function 
49H. 


Input: 

Output: 

Remaiks: 
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Interrupt  21H,  function  33H,  sab-fiinction  0  DOS 

Get  <Ctrl><Break>  flag  (Version  2  and  up) 

Reads  the  <Ctrl><Break>  flag.  This  determines  whether  DOS  should  test  for 
active  <CtrlxC>  or  <Ctrl><Break>  keys  on  each  function  call,  or  on  character 
input/output  calls.  <CtrlxC>  and  <Ctrl:^Break>  trigger  interrupt  23H. 

Input:  AH  =  33H 

AL=  0 

Output:  DL=  0:  Test  only  during  chaiact^  input/ouQ)ut 

DL  =  1:  Test  on  every  function  call 

Remarks:  Since  the  <Ctrl><Break>  flag  is  not  part  of  the  enviroiunent  block  of  a 

program,  it  affects  all  inograms  which  call  the  DOS  character  functions 
that  test  for  <Ctrl><C>  or  the  <Break>  key. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 

Interrupt  21H,  function  33H,  sub-function  1  DOS 

Set  <Ctrl><Break>  flag  (Version  2  and  up) 

Sets  and  unsets  the  <Ctrl><Break>  flag.  Hiis  determines  whether  DOS  should  test 
for  the  activation  of  the  <Ctrl><C>  or  <Ctrl><Break>  keys  on  each  DOS 
function  call  or  character  input/ouQ>ut  calls.  <Ctrl><C>  and  <Ctrl><Break> 
Uiggo’  interrupt  23H. 

Input:  AH=  33H 

AL=  I 

DL  =  0:  Test  only  during  charact^  input/ouQ)ut 
DL=  1:  Test  on  every  function  call 

Output:  No  ouQ)ut 

Remarks:  Since  the  <Ctrl><Break>  flag  is  not  part  of  the  environment  block  of  a 

program,  it  affects  all  {nograms  which  call  the  DOS  character  functions 
that  test  for  <ClrlxC>  or  the  <Break>  key. 

The  contents  of  the  processor  registers  and  the  flag  registers  are  not 
affected  by  this  function. 
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Interrupt  21H,  function  35H  DOS 

Get  interrupt  vector  (Version  2  and  up) 

Returns  the  currait  contents  of  an  intmupt  vecuar  and  the  address  of  the  intmiipt 
routine  that  belongs  to  it. 

Input:  AH=  35H 

AL=  lntanq[)tnumba' 

Output:  ES=  Intranet  routine  segment  address 

BX=  Intorupt  routine  offset  address 

Remarks:  To  ensure  compatibility  with  future  versions  of  DOS,  instead  of  reading 

the  vector’s  contents  directly  from  the  interrupt  vector  table,  call  this 
function  for  reading  an  interrupt  vector. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 

Interrupt  21H,  function  36H  DOS 

Get  free  disk  space  (Version  2  and  up) 

Returns  information  about  the  device  (the  block  driver)  from  which  the 
available  memory  space  can  be  calculated. 

Input:  AH=  36H 

DL=  Devicecode 

OuQ)ut:  AX=  65S3S:  Device  unavailable 

AX<  65535:  Number  of  sectors  per  cluster 
BX=  Numbo*  of  available  clustm 
CX=  Number  of  bytes  per  sector 
DX  =  Total  number  of  clusters  on  the  device 

Remarics:  This  function  identifies  drive  A  as  code  0,  drive  B  as  code  1,  etc. 

The  remaining  memory  on  the  medium  can  be  computed  from  the  number 
of  bytes  per  sector  multiplied  by  the  number  of  sectors  per  cluster, 
multiplied  by  the  numbo'  of  free  clusto^. 

The  contents  of  the  SI,  DI,  BP,  CS,  DS,  SS,  ES  and  the  flag  registers  are 
not  affected  by  this  function. 
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Interrupt  21H,  function  38H  DOS 

Get  country  (Version  2  and  up) 

Determines  country-specific  parameters,  which  are  set  in  the  CONFIG.SYS  file 
using  the  DOS  COUNTRY  command. 

Input:  AH=  38H 

AL=  0 

DS=  BufEersegmoit  address 
DXs  Buffo' offset  address 

Output:  No  ou^ut 

Remarks:  Before  the  function  call,  function  30H  should  be  used  to  detomine  the 

DOS  version.  This  can  help  the  programmer  compensate  for  diffoences 
betweoi  DOS  vosions  during  the  call  and  return  of  this  function. 

The  buffer  must  have  at  least  32  bytes  allocated  for  recording  the  various 
country-specific  parametos. 

Following  the  function  call,  the  individual  bytes  of  this  buffer  contain  the 
following  information : 

Bytes  0-1:  Date  format 

0  =  USA:  Month-day-year 

1  =  Europe:  day-month-year 

2  =  Japan:  Year-month-^y 

Byte  2:  ASCII  code  of  the  currency  symbol 
Byte  3:0 

Byte  4:  ASCII  code  of  the  thousand  characta*  (comma^pmod) 

Byte  5:0 

Byte  6:  ASCII  code  of  decimal  chaiact^  (period/comma) 

Byte  7: 0 

Bytes  8-31:  reserved 

The  contents  of  the  processor  registers  and  the  flag  registers  ate  not 
affected  by  this  fimction. 


Interrupt  21H,  function  38H,  sub-function  0  DOS 

Get  country  (Version  3  and  up) 

Gets  the  country-specific  parameters  that  ate  currently  set 

Input  AH=  38H 

DS=  Buffer  segment  address 

DX=  Buffo' offset  address 

AL=  0:  read  current  country  parameters 

AL=  1-254:  Country  code  parametos  to  be  read 

AL=  255:  Country  code  parametos  to  be  read  placed  in  the  BX  register 
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Ouq>ut: 

Remaiks: 


Carry  flag=0: 0.K. 

Cany  flag=l:  Invalid  country  code 

Before  the  function  call,  function  30H  should  be  used  to  detomine  the 
DOS  version.  This  can  help  the  {mgrammer  compoisate  to  diftoences 
betwera  DOS  versions  during  the  call  and  return  of  this  function. 

The  buffer  must  have  at  least  32  bytes  allocated  for  recording  the  various 
country  specific  parametm. 

Following  the  function  call,  the  individual  bytes  of  this  buffer  contain  the 
following  information: 

Bytes  0-1:  Date  format 

0  =  USA:  Month-day-year 

1  =  Europe:  Day-monA-year 

2  =  Japm:  Year-month-day 

Bytes  2-6:  Currency  indicator  (string  tominated  by  an  end  character) 
Byte  7:  ASCII  code  of  the  thousand  characta*  (c(Mnma^)mod) 

Byte  8: 0 

Byte  9:  ASCII  code  of  decimal  characlo'  (period/comma) 

Byte  10: 0 

Byte  11:  ASCII  code  of  the  date  sqjaration  characto' 

Byte  12:  0 

Byte  13:  ASCII  code  of  the  time  separation  character 
Byte  14: 0 

Byte  15:  Currency  format 

bit  0  =  0:  Currency  symbol  before  the  value 
bit  0=1:  Currency  symbol  after  the  value 
bit  1  =  0:  No  spaces  ^ween  value  and  currency  symbol 
bit  1  =  1:  Space  between  value  and  currency  symbol 
Byte  16:  Precision  (numbo'  of  decimal  places) 

Byte  17:  Time  format 

bit  0  =  0:  12-hour  clock 
bit  0=1: 24-hour  clock 

Bytes  18-21:  Address  of  characto'convasion  routine  (see  below) 

Bytes  22-33:  reserved 

Addresses  18  to  21  are  the  offset  and  segment  addresses  of  a  FAR 
procedure,  which  is  used  for  accessing  the  country  specific  charactos  fimn 
the  character  set  of  the  PC.  The  routine  views  the  AL  register's  contents 
as  the  ASCII  code  of  a  lower  case  letter  that  should  be  converted  to  a 
cig>ital  letter.  If  a  ct^ital  letter  exists,  it  is  retained  in  the  AL  register  after 
the  call.  If  the  letta*  doesn't  exist,  the  contents  of  the  AL  register  remain 
unchanged.  For  example,  the  routine  could  be  used  to  convot  a  lower  case 
"a"  into  a  capital  "A". 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
the  flag  regist^  are  not  affected  by  this  function. 
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Interrupt  llHi  function  38H,  sub*function  1  DOS 

Set  country  (Version  3  and  up) 

Sets  the  current  country-iq)ecific  parameters.  These  parameters  can  be  read  using 
function  38H,  sub-function  0.  Previous  visions  of  IX>S  required  country-specific 
settings  fromthe  CONFIG.SYS  file  using  the  COUNTRY  command.  This 
function  allows  the  uso*  to  set  and  change  these  parameters  after  booting. 


Input: 

AH=  38H 

DX=  65535 

AL=  1-254:  Number  of  the  country 

AL  >  254:  Look  in  BX  for  country  number 
BX  =  Number  of  the  country  (if  AL  >  254) 

Output: 

Carry  fiag=0: 0.K. 

Carry  flag=l:  Invalid  country  code 

V 

Remarks: 

Before  the  function  call,  function  30H  should  be  used  to  determine  that 
this  command  exists. 

This  function  only  allows  setting  of  the  country  code,  for  which  DOS  has 
preset  parameters.  These  parameters  cannot  be  changed  from  this  function. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI, 
regist^  are  not  affected  by  this  function. 

DI,  BP,  CS,  DS,  SS  and  ES 

Interrupt  21H,  function  39H 

Create  subdirectory 

DOS 

(Version  2  and  up) 

Creates  a  new  subdirectory  (xi  the  specified  device. 

Input: 

AH=  39H 

DS=  Subdirectcay  path  segment  address 
DX=  SubdirectcMy  path  offset  address 

Output: 

Carry  flag=0:  Subdirectory  created 

Carry  flag=l:  Error  (AX  =  error  code) 

AX=3:  Path  not  foui^ 

AX=5:  Access  doiied 

Remarics:  The  subdirectory  path  passed  is  an  ASCII  string  which  is  terminated  by 

an  end  character  (ASCII  code  0). 

If  the  subdirectory  path  contains  a  drive  specifier,  the  indicated  device  is 
accessed.  Othowise  DOS  creates  the  subdkectory  on  the  current  device. 

An  error  can  occur  if  any  element  of  the  path  designation  doesn't  exist,  a 
subdirectory  already  »ists  by  that  name,  or  the  directtny  to  be  made  is  a 
subdirectory  of  the  root  directory  and  it  is  already  filled. 
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The  contents  of  the  BX.  CX,  DX.  SI.  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  3AH 
Delete  subdirectory 

Deletes  a  subdirectory  fifom  the  specified  drive. 

AH=  3AH 

DS=  Subdirectory  path  segmoit  address 
DX=  Subdirectory  path  offset  address 

Carry  flag=0:  Subdirectory  deleted 
Carry  flag=l:  ErrcM*  (AX  =  oior  code) 

AX=3:  Path  not  found 
AX=S:  Access  denied 

AX=6:  Directory  to  be  deleted  is  the  current  directory 

Remarks:  The  subdirectory  path  passed  is  an  ASCII  string  which  is  terminated  by 

an  end  character  (ASCn  code  0). 

If  the  subdirectory  path  contains  a  drive  specific,  the  indicated  device  is 
accessed.  Othowise  DOS  deletes  the  subdirectory  from  the  current  device. 

An  errm*  can  occur  if  any  element  of  the  path  designation  doesn't  exist, 
the  subdirectory  is  the  current  directory,  m  the  directwy  to  be  deleted  still 
contains  files. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  3BH  DOS 

Set  current  directory  (Version  2  and  up) 

Sets  the  current  subdirectory  for  the  device  indicated. 

Input:  AH=  3BH 

DS=  Subdirectory  path  segment  address 
DX=  Subdirectory  path  offset  address 

Output:  Carry  flag=;0:  Subdirectory  set 

Carry  flag=l:  Error  (AX  =  error  code) 

AX=3:  Path  not  found 

Remarks:  The  subdirectory  path  passed  is  an  ASCII  string  which  is  terminated  by 

an  end  characto'  (ASCII  code  0). 

If  the  subdirectory  path  contains  a  drive  specifio',  the  indicated  device  is 
accessed.  Otherwise  DOS  deletes  the  subd^tory  from,  the  cunoit  device. 


Input: 


Oufout: 


DOS 
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An  enw  can  occur  if  any  element  of  the  path  designation  doesn't  exist 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  3CH  DOS 

Create  or  truncate  file  (handle)  (Version  2  and  up) 

Creates  a  new  file,  or  dumps  the  contents  of  an  existing  file  (file  size=0  bytes). 
This  function  call  allows  otha  functions  to  read  or  write  to  the  open  file. 

Input:  AH=  3CH 

CX=  File  attribute 

Bit  0=1:  File  is  read  only 

Bit  1  =  1:  Hidden  file 

Bit  2=1:  System  file 

DS=  Fil^iame  segment  address 

DX=  Filename  (^fset  address 

Output:  Cany  flag=0: 0.K.  (AX  =  file  handle) 

Carry  flag=l:  Error  (AX  =  mor  code) 

AX=3:  Path  not  found 
AX=4:  No  available  handle 
AX=5:  Access  denied 

Remarks:  The  various  bits  of  the  file  attribute  can  be  combined  with  each  other. 

The  filename  must  be  available  as  an  ASCII  suing  terminated  by  an  end 
character  (ASCII  code  0).  The  filename  parameter  can  contain  a  driver 
specifier,  path,  filename  and  extrasion.  No  wildcards  are  allowed.  If  you 
omit  the  drive  qrecifier  (m-  path,  DOS  accesses  the  current  drive  (»-  current 
directrxy. 

An  OTOr  can  occur  if  any  element  of  the  path  designation  doesn't  exist,  if 
the  file  must  be  created  in  the  root  directory  which  is  already  full,  or  if  a 
file  with  the  same  name  already  exists  but  cannot  be  cleared  because  it  is 
write  protected  (bit  0  in  the  file  attribute  byte  =  1). 

If  the  function  call  executed  successfully,  all  other  handle  functions  can  be 
called  with  this  handle  once  the  file  opens. 

The  file  pointer  is  set  to  the  first  byte  of  the  file. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  hmction. 
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Interrupt  21H,  function  3DH 
Open  file  (handle) 

Opens  an  existing  file  for  access  by  other  functions. 

Input:  AH=  SDH 

AL=  Accessmode 
Bits  0-2:  Read/write  access 

(XX)(b)  =  File  is  read  only 
(X)l^)  =  File  can  only  be  written 
010^)  =  File  can  be  r^  and  writtra 
Bit  3: 0(b) 

Bits  4-fi:  File  sharing  mode 

(KXKb)  =  Only  current  program  can  access  the  file  (FCB  mode) 
(X)l^)  =  Only  the  curroit  program  can  access  the  file 
010(b)  =  Another  program  can  read  but  not  write  the  file 
01 1^)  =  Anotha*  program  can  write  but  not  read  the  file 
100^)  =  Anotho'  program  can  read  and  write  the  file 
Bit  7:  Handle  flag 

0  =  Child  program  of  the  curr^t  program  can  access  file  handle 
1  =  (Current  program  can  access  file  handle  only 
DS=  Fil^iamesegmm  address 
DX=  Filename  offset  address 

Output:  Carry  flag=0: 0.K.  (AX  =  file  handle) 

Carry  flag=l:  Error  (AX  =  oror  code) 

AX=l:Missing  file  sharing  software 

AX=2:  File  not  found 

AX=3:  Path  not  found  or  file  doesn't  exist 

AX=4:  No  handle  available 

AX=S:  Access  denied 

AX=12:  Access  mode  not  pomitted 

Remarks:  The  filename  must  be  available  as  an  ASCII  string  terminated  by  an  end 

character  (ASCII  code  0).  The  filename  parameter  can  contain  a  driver 
qrecifier,  path,  filename  and  extension.  No  wildcards  are  allowed.  If  you 
omit  the  iive  specifier  or  path,  DOS  accesses  the  current  drive  or  current 
directory. 

If  the  function  call  executes  successfully,  all  othCT  handle  functions  can  be 
called  with  this  handle  once  the  file  opens. 

The  file  pointer  is  set  to  the  first  byte  of  the  file. 

DOS  Version  2  uses  only  bits  0  to  2  of  the  access  mode.  All  other  bits, 
even  under  Version  3,  should  be  0  to  ensure  proper  execution  of  the  call. 

DOS  Version  3  uses  the  file  sharing  mode  in  bits  4  to  6  of  the  access 
mode  only  if  the  file  is  on  a  mass  storage  device  which  is  part  of  a 
network.  These  three  bits  decide  if  and  how  the  file,  while  it  is  open 


DOS 

(Version  2  and  up) 
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using  the  cunent  call,  may  be  accessed  by  other  {Rograms  from  otho*  PCs 
on  the  network. 

Errw  12  can  occur  only  undo'  DOS  Vosion  3  and  only  within  a  netwtwk 
when  the  Hie  is  already  opened  by  another  program  and  if  no  other 
program  can  gain  access  to  that  file. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  nt^  affected  by  this  function. 

Interrupt  21H,  function  3EH  DOS 

Close  file  (handle)  (Version  2  and  up) 

Writes  any  data  in  the  DOS  bufim  to  a  currently  open  file,  then  closes  the  file.  If 
changes  occur  to  the  file,  the  new  file  size  and  the  last  date  and  time  of 
modification  ate  adddi  to  the  directory. 

Input:  AH=  3EH 

BX=  Handle  to  be  closed 

Ou^ut:  Carry  flag=0: 0.K. 

Cany  flag=l:  &ror  (AX  =  onv  code) 

AX=6:  Unauthorized  handle  or  file  not  opened 

Remarks:  Do  not  accidentally  call  this  functidn  with  the  numbers  of  the  previous 

handle  (the  numbers  0  to  4)  because  the  standard  input  device  or  standard 
output  device  may  close,  lliis  Would  leave  you  unable  to  enter  characters 
from  the  keyboard  or  display  charactos  on  the  screoi. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  diis  function. 

Interrupt  21H,  function  3FH  DOS 

Read  file  or  device  (handle)  (Version  2  and  up) 

Reads  a  cotain  number  of  charact^  by  using  a  handle  from  a  jneviously  opened 
file  or  device  and  passes  the  characters  to  a  buffer.  The  read  opoation  starts  at  the 
cunent  file  pointer  position. 

Input:  AH=  3FH 

BX=  File  or  device  handle 
CX=  Numbo' of  bytes  to  be  read 
DS=  Buffer  segment  address 
DX=  Buffar^set  address 

OuQ)ut:  Carry  flag=():O.K.  (AX  =  numba' of  bytes  read) 

Carry  flag=l:  Error  (AX  =  mor  code) 

AX=S:  Access  denied 

AX=6:  Illegal  handle  ex'  file  not  open 
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Remaiks:  Giaiacters  can  be  read  fiom  a  file  or  firom  a  device  (e.g.,  the  standard  input 

device  [keyboard],  which  has  the  handle  0). 

Whoi  the  carry  flag  resets  after  the  function  call  but  the  AX  register  has 
the  value  0,  this  means  that  the  file  pointer  has  already  reached  the  aid  of 
the  file  before  the  function  call.  So,  no  files  could  be  read. 

When  the  carry  flag  resets  afto'  the  function  call  but  the  contents  of  the 
AX  registo'  are  smallo'  than  the  contents  of  the  CX  register  before  the 
function  call,  this  means  that  the  desired  numb^  of  bytes  wasn't  read 
because  the  end  of  the  file  was  reached. 

Aft»  the  fimction  call,  the  file  points  follows  the  last  byte  read. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  fimction. 


Interrupt  21H,  function  40H  DOS 

Write  to  file  or  device  (handle)  (Version  2  and  up) 


Writes  a  certain  number  of  characters  from  a  buffer  to  an  open  file  or  device  by 
using  a  handle.  The  write  opoation  begins  at  the  file  pointer’s  current  position. 


Input: 


Output: 


Remaiks: 


AH=  40H 

BX=  Hie  or  device  handle 
CX=  Numberof  bytes  to  be  written 
DS=  Buffer  segment  address 
DX=  Buffo*  offset  address 

Carry  flag=0: 0.K.  (AX  =  number  of  bytes  written) 

Cany  flagsl:  Error  (AX  =  error  code) 

AX=S:  Access  denied 

AX=6:  Illegal  handle  or  file  not  open 

Characters  can  be  written  to  a  file  or  to  a  device  (e.g.,  the  standard  output 
device  [screen],  which  has  the  handle  1). 

When  the  cany  flag  resets  after  the  function  call  but  the  AX  register  has 
the  value  0,  this  means  that  the  file  pointer  has  already  reached  the  end  of 
the  file  before  the  function  call.  Thoefore  no  files  could  be  written. 


When  the  carry  flag  resets  after  the  function  call  but  the  contents  of  the 
AX  registo*  are  smaller  than  the  contents  of  the  CX  register  before  the 
function  call,  this  means  that  the  desired  number  of  bytes  were  not 
written  because  the  end  of  file  was  reached. 

After  the  function  call,  the  file  pointer  follows  the  last  byte  written. 
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The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP.  CS,  DS.  SS  and  ES 
legists  are  not  affected  by  this  function. 

Interrupt  21H,  function  41H  DOS 

Delete  file  (handle)  (Version  2  and  up) 

Deletes  the  fil^iame  passed  to  the  function.  Through  the  call  of  this  function,  a 
file  is  erased  and  its  name  is  passed  to  the  function. 

AH=  41H 

DS=  Hlename  segment  address 
DX=  Filename  offset  address 

Carry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX  =  enot  code) 

AX=2:  File  not  found 
AX=5:  Access  denied 

The  filename  must  be  available  as  an  ASCII  suing  terminated  by  an  end 
character  (ASCII  code  0).  The  filename  parameter  can  contain  a  drive 
specifier,  path,  filename  and  extension.  No  wildcards  are  allowed.  If  you 
omit  the  drive  specifier  or  path,  DOS  accesses  the  current  drive  or  curroit 
direcuwy. 

An  amt  occurs  when  any  element  of  the  path  designation  doesn't  exist  ot 
when  the  file  has  the  attribute  Read  Only  and  therefore  can  not  be  written 
to  or  deleted.  This  attribute  can  be  changed  by  using  function  43H. 

You  cannot  delete  subdirectories  or  volume  names  with  this  function. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  42H  DOS 

Move  file  pointer  (handle)  (Version  2  and  up) 

Moves  the  file  pointer  of  a  previously  qrened  file  by  using  its  handle.  This  allows 
random  access  because  the  individual  records  don't  have  to  be  read  in  sequence.  The 
new  file  points'  position  is  given  as  an  offset  from  the  current  position,  either 
from  the  beginning  of  the  file  or  from  the  end  of  the  file.  The  offset  itself  is 
indicated  as  a  32-bit  numb^. 

Input:  AH=  42H 

AL=  Offsetcode 

AL=0:  Offset  is  relative  to  the  beginning  of  the  file 
AL=1:  Offset  is  relative  to  the  current  position  of  the  file  points 
AL=2:  Offset  is  relative  to  the  end  of  the  file 
BX=  Handle 

CX=  High  word  of  the  offset 


Input: 


Output: 


Remarks: 
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DX=  Low  wwd  of  the  offset 

OuQ>ut:  Cany  flagsO:  O  JC. 

DX  =  High  wmd  of  the  file  points 
AX  =  Low  w(»d  of  the  file  pointer 
Cany  flag=l:  Enw  (AX  s  enw  code) 

AXsl:  Illegal  t^setcode 

AX=6:  Illegal  handle  or  File  not  open 

Remaiks:  If  offset  codes  1  and  2  are  accessed,  negative  offsets  may  be  used  to  move 

the  file  pointer  backwards  m  to  place  the  pointer  at  the  beginning  of  the 
file.  It's  possible  to  set  the  file  pointer  before  the  end  of  the  file,  which 
causes  an  error  during  the  next  read  or  write  access  to  the  file. 

The  position  of  the  file  pointer  passed  aft^  the  function  call  is  always 
relative  to  the  beginning  of  the  file.  The  offset  code  used  during  the 
function  call  is  independrat  of  this  file  pointer  position. 

Passing  offset  code  2  and  offset  0  returns  the  size  of  the  file.  This  action 
moves  the  file  pointer  to  the  last  byte  of  the  file  and  the  pointer's 
position  returns  to  the  calling  program  after  the  function  call. 

The  contents  of  the  BX,  CX, ,  SI,  DI,  BP,  CS,  DS,  SS  and  ES  registers 
are  not  affected  by  this  function. 

Interrupt  21H,  function  43H,  sub-function  0  DOS 

Get  file  attributes  (Versiou  2  and  up) 

Determines  file  attributes. 

Input:  AH=:  43H 

AL=  0 

DS  =  Filename  segment  address 
DX=  Rlename  offset  address 

Output:  Cany  flag  =  0: 0.K.  (CX  =  file  attribute) 

Bit  (^1:  File  can  be  read  but  not  written 
Bit  1=1:  File  hidden  (not  displayed  on  DIR) 

Bit  2=1:  File  is  a  system  file 

Bit  3=1:  Hie  is  the  volume  name 

Bit  4=1:  File  is  a  subdirecttny 

Bit  S=l:  File  was  changed  since  the  last  date/time 

Cany  flag=  1:  Error  (AX  =  arcM’ code) 

AX=1:  Unknown  function  code 
AX=2:  File  not  found 
AX=3:  Path  not  found 

Remaiks:  The  filename  must  be  available  as  an  ASCII  string  terminated  by  an  end 

character  (ASCII  code  0).  The  filename  parameter  can  contain  a  driver 
specifier,  path,  filename  and  extension.  No  wildcards  are  allowed.  If  you 
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omit  the  drive  specifier  ot  path,  DOS  accesses  die  current  drive  (H’  curroit 
directory. 

An  emM*  occurs  when  any  element  of  the  path  designation  or  the  rile  does 
not  exist. 

The  contents  of  the  BX,  CX, ,  SI,  DI,  BP,  CS,  DS,  SS  and  ES  registos 
are  not  affected  by  this  function. 

Interrupt  21H,  function  43H,  sub<function  1  DOS 

Set  file  attributes  (Version  2  and  up) 

Sets  the  file  attributes. 

Input:  AH=  43H 

AL=  1 

CX=  File  attributes 

BitO  =  1:  File  can  be  read  but  not  written 
Bit  1  =  1:  File  hidden  (not  displayed  on  DIR) 

Bit  2=1:  File  is  a  system  file 
Bit3  =  0 
Bit4  =  0 

Bit  5  =  1:  File  was  changed  since  the  last  dateAime 
DS=  Hlename  segment  address 
DX=  Hlename  offset  address 

OuQiut:  Carry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX  =  error  code) 

AX=1:  Unknown  function  code 
AX=2:  File  not  found 
AX=3:  Path  not  found 
AX=S:  Attribute  cannot  be  changed 

Remarks:  The  filename  must  be  available  as  an  ASCII  string  terminated  by  an  end 

character  (ASCII  code  0).  The  filename  parameter  can  contain  a  driver 
specifier,  path,  filename  and  extension.  No  wildcards  are  allowed.  If  you 
omit  the  drive  specifier  or  path,  DOS  accesses  the  current  drive  or  currait 
directny. 

An  error  occurs  when  any  element  of  the  path  designation  or  the  file  does 
not  exist. 

Neither  subdirectories  nor  volume  names  can  be  accessed  with  this 
function.  For  this  reason  bits  3  and  4  of  the  file  attribute  must  be  0 
during  the  function  call.  If  you  attempt  to  access  a  subdirectory  or  a 
volume  name  anyway,  the  function  returns  oror  code  5. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registm  are  not  affected  by  this  function. 
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Interrupt  21H,  function  44H,  sub-function  0  DOS 

lOCTL:  Get  device  information  (Version  2  and  up) 

p^mits  access  of  a  characto'  drive’s  device  attribute. 


Input: 


Output: 


Remailcs: 


AH=  44H 
AL=  0 
BX=  Handle 

Carry  flag=0:  OX..  (DX  =  device  attribute) 

Bit  14=  1:  Processes  control  characim  duough  lOCTL 
Bit  7  =  1:  Characto’  driver 
BitS=  0:  Codeed  mode  opaatkm 
1:  Raw  mode  op^^on 
Bit  3  =  1:  Qock  driver  opoation 
Bit2=  l:NULdriva'(q)eration 
Bit  1  =  1:  COnsde  output  drivo'  (screen) 

Bit  0  =  1:  Console  input  driver  (keyboard 
Carry  £lag=l:  Enw  (AX  =  error  code) 

AX=1:  Unknown  function  code 
AX=6:  Handle  not  opoied  or  does  not  exist 

A  handle  is  passed  (not  the  name  of  the  addressed  character  driva  which 
must  be  connected  with  this  driver).  This  can  be  one  of  the  five  pre¬ 
assigned  handles  (0  to  4).  A  handle  could  have  been  previously  opmed  for 
a  certain  device  with  the  help  of  the  Opoi  function  (function  3DH),  and 
then  passed  to  the  function.  For  example,  since  the  standard  input  and 
output  devices  (handles  0  and  1)  can  be  redhected,  this  method  assures  that 
the  indicated  device  is  accessed. 

If  bit  7  in  the  device  attribute  is  unequal  to  1,  the  driver  addressed  is  not  a 
character  driver  and  the  significance  of  the  individual  bits  in  the  device 
attribute  disagrees  with  those  of  the  device  drivo*. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registo^  are  not  affected  by  this  function. 


Interrupt  21H,  function  44H,  sub-function  1  DOS 

lOCTL:  Set  device  information  (Version  2  and  up) 

Sets  the  character  device  attributes. 


Input:  AH=  44H 

AL=  1 
BX=  Handle 

CX=  Numberof  bytes  written 
DX=  Device  attributes 

Bit  14=  1:  Processes  control  chaiacto^  through  lOCTL  using  sub¬ 
functions  2  and  3 
Bit  7  =  1:  Characto'  drivo* 
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Bit  5  =  0:  Cooked  mode  <q)aation 
Bit  5  =  1:  Raw  mode  opoation 
Bit  3  =  1:  Clock  driver  (q)aation 
Bit  2=1:  NUL  driver  operation 
Bit  1  =  1:  Console  ouQxit  driver  (screen) 

Bit  0=1:  CtHisole  iiq)ut  driver  (keyboard 

OuQ>ut:  Carry  flag=0: 0.K. 

Carry  fla^l:  Error  (AX  =  Emv  code) 

AX=1:  Unknown  function  code 

AX=6:  handle  not  opened  or  handle  does  not  exist 

Remarks:  A  handle  is  passed  but  it  is  not  the  name  of  the  addressed  character  device, 

which  must  be  connected  with  this  device.  This  can  be  one  of  the  five 
pre-assigned  handles  (0  to  4).  A  handle  could  have  previously  been 
opened,  with  the  Open  function,  for  a  certain  device  and  then  passed  to  the 
function.  For  example,  since  the  standard  input  and  output  devices 
(handles  0  and  1)  can  be  redirected,  this  method  assures  that  the  indicated 
device  is  accessed. 

To  change  various  device  attribute  bits  with  this  function,  use  sub¬ 
function  0  to  read  the  device  attributes  first  Then  this  sub-function  can 
reset  the  device  attribute  bits  in  the  device  driver. 

If  bit  7  in  the  device  attribute  is  unequal  to  1,  the  driver  addressed  is  not  a 
character  driv^.  The  meanings  of  the  individual  bits  in  the  device  attribute 
disagree  with  those  in  the  device  drivo'. 

This  fimction  is  eq)ecially  useful  for  switching  between  codced  mode  and 
raw  nnode  within  a  characto*  driv»  (bit  5). 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  fimction. 

Interrupt  21H,  function  44H,  sub-function  2  DOS 

lOCTL:  Read  data  from  character  device  (Version  2  and  up) 

Reads  data  from  a  character  device.  This  fimction  defines  the  number  of  bytes  of 
data  to  read  from  the  buffer,  which  contains  the  data  taken  from  the  character 
device. 


Input  AH=  44H 

AL=  2 
BX=  Handle 

CX=  Numbo:  of  bytes  to  be  read 
DS=  Buffer  segment  address 
DX=  Buffo't^set  address 
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Ouq)ut:  Carry  flag=0: 0.K.  (AX  =  Numbo*  of  bytes  sent) 

Carry  Error  (AX  =  Error  code) 

AXsl:  Unknown  function  code 
AX=6:  Handle  not  opoied  (h*  does  not  exist 

Remarks:  A  handle  is  passed,  but  it  is  not  the  name  of  the  addressed  character  device 

which  must  be  connected  with  this  device.  This  can  be  one  of  the  five 
pre-assigned  handles  (0  to  4).  A  handle  could  have  previously  been  opoied 
with  the  Open  function  (function  number  SDH)  for  a  certain  device,  then 
passed  to  Ae  function.  For  example,  since  the  standard  input  and  output 
devices  (handles  0  and  1)  can  be  redirected,  this  method  assures  that  the 
indicated  device  is  accessed. 

An  error  always  occurs  if  the  handle  passed  is  connected  with  a  block 
driva  instead  of  a  characto:  driva-. 

The  dtiva  defines  the  data  type  and  structure. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registas  are  not  affected  by  this  function. 

Interrupt  21H,  function  44H,  sub-function  3  DOS 

lOCTL:  Send  data  to  character  device  (Version  2  and  up) 

Sends  data  from  an  application  program  directly  to  a  character  device.  The  calling 
function  defines  the  numba  of  bytes  to  be  transfared  from  a  buffer  to  the  device. 

Input:  AH=  44H 

AL=  3 
BX=  Handle 

CX=  Numba  of  bytes  to  be  transmitted 
DS=  Buffa  segment  address 
DX=  Buffa  offsa  address 

Output:  Carry  flag=0: 0.K. 

AX  =  Number  of  bytes  sent 
Carry  flag=l:  Etra  (AX  =  Error  code) 

AX=1:  Unknown  function  code 
AX=6:  Handle  not  opened  or  does  not  exist 

Remarks:  A  handle  is  passed,  but  it  is  not  the  name  of  the  addressed  character  device 

which  must  be  connected  with  this  device.  This  can  be  one  of  the  five 
pre-assigned  handles  (0  to  4).  A  handle  could  have  previously  been  (^ned 
with  the  Open  function  (function  number  61)  fa  a  certain  device,  then 
passed  to  the  function.  For  example,  since  the  standard  input  and  output 
devices  (handles  0  and  1)  can  be  redirected,  this  method  assaes  that  the 
indicated  device  is  accessed. 

An  error  always  occurs  if  the  handle  passed  is  connected  with  a  block 
driver  instead  of  a  character  driva. 
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Hie  driver  defines  the  data  type  and  stracture. 

The  contents  of  the  BX,  CX,  DX,  SI,  Dl,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  fiinctKML 

Interrupt  21H,  function  44H,  sub-function  4  DOS 

lOCTL:  Read  data  from  block  device  (Version  2  and  up) 

Reads  data  fcv  an  {plication  directly  from  a  block  device.  The  calling  function 
defines  the  number  of  bytes  to  be  copied  by  the  device  into  a  buffer. 

Input:  AH=  44H 

AL=  4 

BX=  Device  designation 
CX=  Numbo' of  bytes  to  be  read 
DS=  Buffer  segment  address 
DXs  Buffo’ offset  address 

Output*  Carry  flag=0: 0.K. 

AX  =  Number  of  bytes  soit 
Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Unknown  function  code 
AX=1S:  Unknown  device 

Remaiks:  Instead  of  defining  the  device  driver,  the  device  designation  parameter 

defines  the  device  from  which  data  will  be  received.  Code  0  represents 
device  A;,  1  represents  device  B:,  etc. 

The  driver  defines  the  data  type  and  structure. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  fimction. 

Interrupt  21H,  function  44H,  sub-function  5  DOS 

lOCTL:  Send  data  to  block  device  (Version  2  and  up) 

Sends  data  from  an  application  program  directly  to  a  character  device.  The  calling 
function  defines  the  numbo'  of  bytes  to  be  transfored  fiom  a  buffer  to  the  device. 

Input:  AH=:  44H 

AL=  5 

BX=  Device  designation 
CX=  Number  (kbytes  to  be  sent 
DS=  Buffer  segment  address 
DX=  Buffer  offset  address 

Output*  Carry  flag=0: 0  JC.  S 

AX  =  Number  of  bytes  sent 
Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Unknown  function  code 
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AXslS:  Unknown  device 

Remaiks:  Instead  of  defining  the  device  driver,  the  device  designation  parameter 

defines  the  device  from  which  data  will  be  received.  Code  0  represents 
device  A:,  1  represoits  device  B:,  etc. 

The  drivo’ defines  the  data  type  and  structure. 

The  contents  of  the  BX,  CX.  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  44H,  sub>function  6  DOS 

lOCTL:  Read  input  status  (Version  2  and  up) 

Detomines  whetha  a  device  driva*  can  transmit  data  to  an  plication  program. 


Input: 

AH=  44H 

AL=  6 

BX=  Handle 

Output: 

Carry  flag=0: 0 JC.  (AX  =  Input  status) 

AXsO:  Driver  not  ready 
AX=255:  Driver  ready 


Cany  flag=l:  Enor  (AX  =  Error  code) 

AX=1:  Unknown  function  code 
AX=S:  Access  denied 

Remaiks:  The  handle  passed  can  refo-  to  eitha-  a  character  driver  or  a  file. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  fiinction. 

Interrupt  21H,  function  44H,  sub-function  7  DOS 

lOCTL:  Read  output  status  (Version  2  and  up) 

Detomines  whether  a  device  driv»  can  receive  data  from  an  igiplication  program. 


Input: 

AH=  44H 

AL=  7 

BX=  Handle 

Output: 

Carry  flag^:  O.K.  (AX  =  Output  status) 

AX=0:  Driver  is  not  ready 
AX=255:  DiivCT  is  ready 


Carry  flag=l:  Error  (AX  =  Error  code) 
AX=1:  Invalid  frinction  number 
AXs5:  Access  denied 
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Remaiks:  The  handle  passed  can  refer  to  eitho' a  characto'driva’ or  a  file. 

If  the  handle  refos  to  a  file,  the  block  device  dmer  signals  its  readiness  to 
receive  data,  even  if  the  medium  containing  the  file  is  full  and  no 
additional  data  can  be  ^rpended  to  the  end  of  the  file. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  functicMi. 

Interrupt  21H,  function  44H,  sub-function  8  DOS 

lOCTL:  Test  for  changeable  block  device  (Version  3  and  up) 

Determines  whether  the  block  device  medium  (e.g.,  disk,  hard  disk,  etc.)  can  be 
changed. 


Input 

AH=  44H 

AL=  8 

BLs  Device  designation 

Ouqrut 

Carry  flag=0: 0.K.  (AX=status  code) 
AX  =  0:  Medium  changeable 

AX  =  1:  Medium  unchangestble 
Carry  flag=l:  Ertw  (AX = Error  code) 
AX=1:  Invalid  function  number 
AX=1S:  Invalid  drive  numba 

Remarks:  The  device  designation  paramet^  defines  the  device  being  addressed  instead 

of  the  device  driver.  Code  0  rquesents  device  A:,  1  represents  device  B:, 
etc. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registas  are  not  affected  by  this  function. 

Interrupt  21H,  function  44H,  sub-function  9  DOS 

lOCTL:  Test  for  local  or  remote  drive  (Version  3.1  and  up) 

Determines  whether  a  drive  (block  device)  is  local  (part  of  the  PC  making  the 
inquiry)  or  remote  (part  of  anotha  PC  in  a  network). 


Input-  AH=  44H 

AL=  9 

BL=  Device  designation 

Ouqrut  Carry  flag=0: 0.K. 

DX  =  device  attribute 
Bit  12  =  0:  Locd 
Bit  12  =  1:  Remote 
Carry  flag=l:  Errw  (AX  =  Error  code) 
AX=1:  Invalid  function  number 
AX=15:  Invalid  drive  specification 
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Remaiks:  You  can  access  this  sub-function  only  if  networking  software  has 

jneviously  been  installed. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  44H,  sub-function  OAH  DOS 

lOCTL:  Test  for  local  or  remote  handle  (Version  3.1  and  up) 

Determines  whether  a  file  associated  with  this  handle  is  local  (part  of  the  PC 
making  the  inquiry)  or  ronote  (part  of  anotha  PC  in  a  netwtxk). 


Input: 

AH=  44H 

AL=  OAH 

BX=  Handle 

Output: 

DX=  lOCTLcode 

Bit  IS  =  0:  Local 

Bit  IS  =  1:  Remote 

Carry  flag=l:  Error  (AX  =  Enw  code) 

AX=1:  Invalid  function  number 

AX=6:  Handle  not  opoiedrv  does  not  exist 

R^narks: 

You  can  access  this  sub-function  only  if  networking  software  has 
previously  been  installed. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  fimction. 

Interrupt  21H,  function  44H,  sub-function  OBH 
lOCTL:  Change  retry  count 

DOS 

(Version  3  and  up) 

Sets  the  variables  that  specify  the  number  of  attempts  at  file  access.  One  PC 
within  a  netwmk  may  try  to  access  a  file  that  is  already  being  accessed  by  another 
PC.  The  PC  attempting  access  repeats  the  file  access  procedure  the  number  of 
times  and  the  numb^  of  waiting  periods  defined  by  these  variables. 

Input:  AH=  44H 

AL=  OBH 

BX=  Numba*  of  attempts 

CX=  Waiting  time  between  attempts 

Output:  Carry  fiag=0: 0  JL 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function  number 

Remarks:  You  can  only  access  this  sub-fuiKtion  if  networking  software  has 

previously  bem  installed. 
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The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  45H  DOS 

Duplicate  handle  (Version  2  and  up) 

Creates  a  duplicate  of  the  handle  passed.  This  duplicate  handle  interfaces  with  the 
same  file  or  device  as  the  Erst  handle.  If  the  first  handle  refers  to  a  file,  the  value  of 
the  first  handlo^'s  file  pointer  joins  with  the  file  pointer  of  the  duplicate  handle. 

Input:  AH=  45H 

BX=  Handle 

Ou^ut'  Carry  flagsO:  O.K.  (AX  =  the  new  handle 

Clarry  fla^l:  Error  (AX  =  ErrcH*  code) 

AX=4:  No  additional  handle  avaiMle 
AXsfi:  Handle  not  opened  or  does  not  exist 

Remarks:  Without  having  to  close  the  file,  this  function  updates  a  file  directory 

entry  after  its  modification.  A  file  can  be  closed  using  function  62  (3EH). 

If  the  file  pointer  of  one  of  the  two  handles  changes  position  due  to  the 
call  of  a  read  or  write  function,  the  other  file  pointer  also  changes 
automatically. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  46H  DOS 

Force  duplicate  of  handle  (Version  2  and  up) 

Refers  a  second  file  handle  to  the  save  device  or  file  as  the  first  file  handle.  The 
second  handle's  file  pointer  also  contains  the  same  value  as  the  first  handle's  file 
pointer. 


Input: 

AH=  46H 

BX=  First  handle 

CX=  Second  handle 

Output: 

Carry  flag=0: 0.K. 

Cmy  flag=l:  Error  (AX  =  Error  code) 

AX=4:  No  additional  handle  available 
AX=6:  Handle  not  opened  or  does  not  exist 

Remarks:  If  the  function  call  connects  the  second  handle  to  an  open  file,  the  file 

closes  befne  the  forced  duplication. 

If  the  file  pointm*  of  one  of  the  handles  changes  position  due  to  the  call  of 
a  read  or  write  function,  the  otho'  file  pointo*  also  changes  automatically. 
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The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  function. 

Interrupt  21H,  function  47H  DOS 

Get  current  directory  ^  (Version  2  and  up) 

Gets  an  ASCII  string  listing  the  complete  path  designaticMi  of  the  currmt  directray 
of  the  indicated  device.  This  siring  passes  to  the  specified  buffo'. 

Input:  AH=  ^7H 

DLs  Device  designation 
DS=  Buffer  segmoit  address 
SI=  Buffo  offset  address 

Ouq>ut:  Carry  flag=0: 0.K. 

Carry  flag=l:  Eiior  (AX=Enor  code) 

AX=1S:  Invalid  drive  specificatioi 

Remarks:  The  device  designatioi  poameter  defines  the  device  being  addressed  instead 

of  the  device  drivo.  Code  0  represents  the  current  device,  1  represoits 
device  A:,  etc. 

Hie  path  description  in  the  buffer  tominates  with  an  end  character  (ASCII 
code  0).  This  description  has  no  drive  specifier  or  \  character  (root 
directoy  specifier).  If  the  root  directory  is  the  current  directory,  the  end 
character  bkxMnes  the  first  character  in  the  buffo. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  48H 
Allocate  memory 

Reserves  an  area  of  memory  for  program  use. 

Input:  AH=  4gH 

BX=  Number  of  paragraphs  to  be  lesoved 

OuQiut:  Carry  flag=0: 0.K. 

AX=Memory  area  segment  address) 

Cany  flag=l:  Error  (AX  =  Enor  code) 

AX=7:  Memory  control  block  destroyed 
AX=8:  Insufficient  memory 
BX=  Number  of  paragraphs  available 

Remadcs:  A  paragr^h  consists  of  16  bytes. 


DOS 

(Version  2  and  up) 
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If  memory  allocation  was  successfully  executed,  the  allocated  range 
begins  at  address  AX:0000. 

This  function  always  fails  when  executed  from  within  a  COM  program 
because  the  PC  assigns  the  total  amount  of  free  memory  to  a  COM 
program  when  it  executes. 

The  contents  of  the  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES  registers 
are  not  affected  by  this  function. 

Interrupt  21H,  function  49H  DOS 

Release  memory  (Version  2  and  up) 

Releases  memmy  previously  allocated  by  function  72  (49H — ^see  above)  for  any 
purpose. 


AH=  49H 

ES  =  Memory  area  segmrat  address 

Carry  flag=0: 0.K. 

Cany  flag=l:  Error  (AX  =  Error  code) 

AX=7:  Memory  control  block  destroyed 
AX=9:  Incorrect  memory  area  passed  in  ES 

Since  DOS  knows  the  size  of  the  memory  area  to  be  released,  no 
parameter  exists  fw  passing  memwy  size. 

If  the  wrong  segment  address  appears  in  the  ES  register  during  the 
function  call,  memory  assigned  to  another  program  can  be  released.  This 
can  lead  to  a  system  crash  or  other  consequences. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  fimction. 


Interrupt  21H,  function  4 AH 

DOS 

Modify 

memory  allocation 

(Version  2  and  up) 

Changes  the  size  of  a  memory  area  previously  reserved  using  function  72  (3FH — 
see  above). 

Input: 

AH=  4AH 

BX=  New  memory  area  size  in  paragrrq^s 
ES=  Memwy  area  segment  address 

Output* 

C^arry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=7:  Memory  control  block  destroyed 
AX=8:  Insufficient  memory 

BX=  Number  of  paragrtqths  available 

Input: 

Ouqrut: 

Remarks: 
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Remaiks:  A  paragn^  has  16  bytes. 

If  the  wrong  segment  address  appears  in  the  ES  register  during  the 
function  call,  memory  assigned  to  another  jHogram  can  be  released.  This 
can  lead  to  a  system  crash  or  other  consequences. 

Since  the  PC  assigns  the  total  amount  of  free  memory  to  a  COM 
IHOgram  when  it  ^ecutes,  this  function  call  always  fails  when  executed 
from  within  a  COM  program. 

COM  programs  should  use  this  function  to  release  all  unnecessary 
memory  since  all  RAM  becomes  part  of  a  COM  program.  This  is 
especitdly  important  before  calling  the  EXEC  function  (function  number 
75  (4BH). 

The  contents  of  the  CX.  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES  registers 
are  not  affected  by  this  function. 

Interrupt  21H,  function  4BH,  sub-function  0  DOS 

Execute  program  (Version  2  and  up) 

Executes  another  program  from  within  a  program  and  continues  execution  of  the 
original  program  sitet  the  called  program  finishes  its  run.  The  function  requires  the 
name  of  the  program  to  be  executed  and  the  address  of  a  parameter  block,  which 
contains  information  that  is  important  to  the  function. 

Input:  AH=  4BH 

AL=  0 

ES=  Parameter  block  segment  address 
BX=  ParametCT block  offset  address 
DS  =  Rogram  name  segmoit  address 
DX=  Program  name  offset  address 

Ouqrut:  Carry  flag=0:  OX. 

Carry  fla^l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  functioi  number 
AX=2:  Path  or  program  not  found 
AX=S:  Access  denied 
AX=8:  Insufficiratmemoy 
AX=  10:  Wrong  enviroiunent  block 
AX=1 1:  Incorrect  format 

Remarks:  The  direcbny  name  passed  is  an  ASCII  string  which  is  terminated  by  an 

end  characto’  (ASCII  code  0).  It  can  contain  a  path  designation  and  drive 
specifier.  No  wildcards  are  allowed.  If  no  drive  specifier  or  path 
designation  exists,  the  function  accesses  the  currmit  drive  or  directory. 

Only  EXE  or  COM  programs  can  be  executed.  To  execute  a  batch  file, 
the  conunand  processor  (COMMAND.COM)  must  be  called  using  the  /c 
parameto’  followed  by  the  name  of  the  batch  file. 
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The  parametCT  block  must  have  the  following  fmnat: 

Bytes  0-1:  Enviionm^it  block  segment  address 

Bytes  2-3:  Command  parameter  offset  address 
Bytes  4-S:  Command  parameto'segmait  address 

Bytes  6-7:  First  FCB  offset  address 

Bytes  8-9:  First  FCB  segm«it  address 
Bytes  10-11:  Second  FCB  dfset  address 
Bytes  12-13:  Second  FCB  segment  address 

If  the  segment  address  oi  the  ravircHiment  Mock  is  a  0,  the  called  program 
has  the  same  environmoit  block  as  the  calling  program. 

The  command  parameters  must  be  stored  so  that  the  parameter  string 
begins  with  a  byte  representing  the  number  of  characters  in  the  command 
line.  Next  follow  the  individual  ASCII  characters,  which  are  terminated 
by  a  carriage  return  (ASCII  code  13)  (this  carriage  return  is  not  counted  as 
acharact^). 

The  first  FCB  passed  is  copied  to  the  PSP  of  the  called  program  starting 
at  address  SCH.  The  second  FCB  passed  is  copied  to  fhe  PSP  of  the  called 
program  starting  at  address  6CH.  If  the  called  program  does  not  obtain 
infwmatitm  from  the  two  FCBs,  any  desired  value  can  be  entered  into  the 
FCB  fields  at  the  peaamstet  block. 

Aft»  the  call  of  this  function,  all  registers  are  destroyed  except  the  CS 
and  IP  registers.  Fch*  later  recall,  save  their  contents  l^fore  the  function 
call. 

The  program  called  should  have  all  the  handles  available  to  the  calling 
program. 

Interrupt  21H,  function  4BH,  sub-function  3  DOS 

Execute  overlay  (Version  2  and  up) 

Loads  a  second  program  into  memory  as  an  overlay  without  automatically 
executing  the  second  program. 

Input:  AH=  4BH 

AL=  3 

ES=  Parameta  block  segment  address 
BX=  ParametCT  block  offset  address 
DS=  Program  name  segment  address 
DX=  Program  name  offset  address 

Output:  Carry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  functiai  number 

AX=2:  Path  a*  program  not  found  ^ 

AX=S:  Access  denied  ' 

AX=8:  Insufficioit  memory 
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AX=10:  Wrong  environment  Uock 
AXsll:  Inconect  fonnat 

Remarics:  The  directtvy  name  passed  is  an  ASCII  string  which  is  terminated  by  an 

end  characto’  (ASQI  code  0).  It  can  contain  a  path  designation  and  drive 
specifier.  No  wildcards  are  allowed.  If  no  drive  specifier  or  path 
(Agnation  exists,  the  function  accesses  the  currait  drive  or  directory. 

Only  EXE  or  COM  i»ograms  can  be  executed.  To  execute  a  batch  file, 
the  command  processor  (COMMAND.COM)  must  be  called  using  the  /c 
paramo  followed  by  the  name  of  the  batch  file. 

The  parameter  block  must  have  the  following  format 

Byte  0-1:  Segment  address  wh»e  the  ovo'lay  will  be  stored 

((^setaddress=0) 

Byte  2-3:  Relocation  factor 

The  relocation  factor  requires  the  value  0  fen  COM  programs.  Use  the 
segmoit  address  at  which  the  program  should  load  when  accessing  EXE 
programs. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  fimetion. 

Interrupt  21H,  function  4CH  DOS 

Terminate  with  return  code  (Version  2  and  up) 

Terminates  a  program  and  passes  an  end  code  fen  which  function  77  (4DH-see 
below)  searches.  This  function  releases  the  memtny  previously  occupied  by  the 
tmninated  program. 

Input  AH=  4CH 

AL=  Return  code 

Output  No  ouq)ut 

Remarics:  This  function  may  be  used  fin  program  termination  instead  of  the  other 

functions  listed  earlier. 

This  function  call  restores  the  contents  of  the  three  interrupt  vectors  that 
were  stored  in  the  PSP  when  the  program  started  execution. 

Before  passing  control  to  the  calling  program,  all  handles  opened  by  this 
inogram  close,  along  with  the  cenresponding  files.  This  is  not  applicable 
to  files  accessed  using  FCBs. 

A  batch  file  can  test  for  the  return  code  using  the  ERRORLEVEL  and  IF 
batch  commands. 
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Interrupt  21H,  function  4DH  DOS 

Get  return  code  (Version  2  and  up) 

Checks  a  program,  called  from  another  i»ogram  by  the  EXEC  function,  for  the 
return  code  passed  by  the  calted  iHOgram  when  it  tmninates. 

Input:  AH=  4DH 

Ou^ut:  AH=  Type  of  program  termination 

AH=0:  Normal  end 

AH=1:  End  through  <CtrlxC>  or  <Break> 

AH=2:  Device  access  error 
AH=3:  Call  of  function  49  (31H) 

AL=  Retumcode 

Remarks:  Hiis  function  reads  the  return  code  of  the  called  program  only  once. 

The  contents  of  the  AX,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
flag  registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 

Interrupt  21H,  function  4EH  DOS 

Search  for  first  match  (Version  2  and  up) 

Searches  for  the  first  occurrence  of  the  filename  listed.  The  file  can  have  certain 
attributes,  so  a  search  can  be  made  through  subdirectoies  and  volume  names. 

Input  AH=  4EH 

CX=  File  attribute 

DS=  Filename  segment  address 

DX=  Filoiame  offset  address 

Output  C^arry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=2:  Path  not  found 

AX=18:  No  file  with  the  attribute  found 

Remarks:  The  directory  tuune  passed  is  an  ASCII  string  which  is  terminated  by  an 

end  characte'  (ASCII  code  0).  It  can  contain  a  path  designatirm  and  ^ve 
specifier.  No  wildcards  are  allowed.  If  no  drive  specifier  or  path 
designation  exists,  the  function  accesses  the  current  drive  or  directray. 

The  search  defaults  to  normal  files  (attribute  0).  Any  set  attribute  bits 
extends  the  search  to  normal  files  and  any  otfao'  file  types. 

If  a  matching  file  occurs,  the  first  43  bytes  of  the  DTA  contain  the 
following  information  about  this  file: 

Bytes  0-20:  Resoved 

Byte  21:  File  attribute 

Bytes  22-23:  Time  of  last  modification  to  file 
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Bytes  24-25:  Date  of  last  modification  to  file 
Bytes  26-27:  Low  word  of  file  size 
Bytes  28-29:  High  wend  of  file  size 
Bytes  30-42:  ASGD  filename  and  extension  tmninated 
by  an  aid  chaiacta  (ASCII  code  0) 

This  function  may  only  be  called  to  search  for  the  first  occurrence  of  a 
file.  If  you  want  to  search  for  a  group  of  files  using  wildcards,  function 
4FH  (see  below)  must  be  called 

The  contents  of  the  BX.  CX,  DX,  SI,  Dl,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  4FH  DOS 

Search  for  next  match  (handle)  (Version  2  and  up) 

Searches  for  subsequent  occurrences  of  the  filename  listed  afta  function  78  (above) 
executed  successfully. 

Input:  AH=  4FH 

Output  Carry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX=Enor  code) 

AX=18:  No  other  files  found  with  this  attribute 

Remarks:  If  a  matching  file  occurs,  the  first  43  bytes  of  the  DTA  contain  the 

following  information  about  this  file: 

Bytes  0-20:  Reserved 
Byte  21:  File  attribute 

Bytes  22-23:  Time  of  last  modification  to  file 
Bytes  24-25:  Date  of  last  modification  to  file 
Bytes  26-27:  Low  word  of  file  size 
Bytes  28-29:  High  word  of  file  size 
Bytes  30-42:  ASCII  filename  and  extension  terminated 
by  an  aid  character  (ASCII  code  0) 

This  function  can  only  be  called  if  function  4EH  has  been  called  once  and 
if  the  DTA  remains  unchanged. 

The  contents  of  the  BX,  CX,  DX,  SI,  Dl,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 
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Interrupt  21H,  function  54H  DOS 

Get  verify  flag  (Version  2  and  up) 

Gets  the  current  status  of  the  verify  flag.  This  flag  determines  whether  or  not  data 
transmitted  to  a  medium  (floppy  disk  or  hard  disk)  should  be  verified  after  the 
transmission. 

Input  AH=  54H 

Output  AL  =  Verify  flag 

AL=0:  VCTify  off 
AL=1:  Vaify  on 

Remaiks:  Function  2EH  (see  above)  contrds  the  status  of  the  verify  flag. 

The  contents  of  the  AH,  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  and 
flag  registos  are  not  affected  by  this  fimction. 

Interrupt  21H,  function  56H  DOS 

Rename  file  (handle)  (Version  2  and  up) 

Renames  a  file  w  moves  the  file  to  anothe*  directory  of  a  block  device.  Moving  is 
possible  only  within  the  difiinent  directories  of  one  particular  device  (i.e.,  you  can't 
move  a  file  from  a  hard  disk  directory  to  a  floppy  di^  directory). 

Input  AH=  56H 

DS=  Old  filename  segment  address 
DX=  Old  filename  offset  address 
ES  =  New  filoiame  segment  address 
DI  =  New  filename  offset  address 

Ouqrut  Carry  flag=0:  O.K. 

Carry  flag^l:  Error  (AX  s  ErnM*  code) 

AX=2:  File  not  found 
AXs3:  Path  not  found 
AX=S:  Access  denied 
AX=1 1;  Not  the  same  device 

Remarks:  The  directory  name  passed  is  an  ASCII  string  which  is  terminated  by  an 

end  charact^  (ASCII  code  0).  It  can  contain  a  path  designation  and  drive 
specifier.  No  wildcards  are  allowed.  If  no  drive  specifier  or  path 
designation  exists,  the  function  accesses  the  current  drive  <»’  directmy. 

An  oior  occurs  if  you  attempt  to  move  the  file  to  a  filled  root  directory. 

This  function  carmot  access  subdirectories  or  volume  names. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registm  are  not  affected  by  this  function. 
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Interrupt  21H,  function  57H,  sub-function  0  DOS 

Get  file  date  and  time  (Version  2  and  up) 

Gets  the  date  and  time  of  the  oeation  or  last  modifkatkm  of  a  file. 


Input 

AH=  57H 

AL=  0 

BX»  Handle 

Ou^t 

Carry  flag=0: 0.K. 

CX=Tiine 

DX^Daie 


Carry  flag=l:  Error  (AX  =  Emv  code) 

AX=1:  Invalid  fimction 
AX=6:  hiA^d  handle 

Remarks:  In  order  for  it  to  be  accessed  with  a  handle,  the  file  must  have  been 

previously  qrened  or  created  using  one  of  the  handle  functions. 

The  time  appears  in  the  (TX  register  in  the  following  format: 

Bits  0-4:  Seconds  in  2-second  irKrements 

Bits  S-10:  Minutes 

Bits  11-15:  Hours 

The  date  qrpears  in  the  DX  register  in  the  following  format: 

Bits  0-4:  Day  of  the  month 

Bits  S-8:  Month 

Bit  9-15:  Year  (relative  to  1980) 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
regist»s  are  not  affected  by  this  function. 

Interrupt  21H,  function  57H,  sub-function  1  DOS 

Set  fiie  date  and  time  (Version  2  and  up) 

Stores  the  date  and  time  of  the  creation  or  iast  modification  of  a  file  in  the 
corre^)onding  file  and  device. 

Input  AH=  57H 

AL=  1 
BX=  Handle 
CX=  Time 
DX=  Date 

Output  Carry  flag=0: 0.K. 

Cany  f1ag=l:  Error  (AX  =  Error  code) 

AX=T:  Invalid  function 
AX=6:  Invalid  handle 
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Ronaiks:  In  ordo^  to  be  accessed  with  a  handle,  the  file  must  have  been  pfeviously 

opened  (m*  created  using  one  of  the  handle  functions. 

The  time  appears  in  the  CX  register  in  the  following  format: 

Bits  0-4:  Seconds  in  2-second  increments 

Bits  S-10:  Minutes 

Bits  11-15:  Hours 

The  date  tgypears  in  the  DX  register  in  the  following  format: 

Bits  0-4:  Day  of  the  month 

Bits  S-8:  Month 

Bit  9-15:  Year  (relative  to  1980) 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registos  are  not  affected  by  this  function. 

Interrupt  21H,  function  58H,  suh-function  0  DOS 

Get  allocation  strategy  (Version  3  and  up) 

Determines  the  method  currently  in  use  by  MS-DOS  for  allocating  blocks  of 
memwy.  If  a  program  allocates  memory  using  function  48H,  different  programs  in 
memory  may  already  have  memory  blocks  assigned  to  them.  Since  these  requested 
memory  blocks  vary  in  size,  DOS  has  three  methods  of  allocating  memory  to  a 
program: 


•  First  fit:  DOS  starts  searching  at  the  start  of  memory  and  allocates  the 
first  memory  block  it  finds  of  the  requested  size; 

•  Best  fit*  DOS  searches  all  available  memwy  blocks  and  allocates  the 
smallest  suitable  memory  block  it  finds  (the  most  efficient  method); 

•  Last  fit:  DOS  starts  searching  at  the  rad  of  memory  and  allocates  the  first 
memtuy  block  it  finds  of  the  requested  size. 

Input  AH=  58H 

AL=  0 

Output  Carry  flag=0:  OX 

AX=0:  First  fit  (start  from  beginning  of  memtwy) 

AX=1:  Best  fit  (search  for  best-fitting  memory  block) 

AX=2:  Last  fit  (start  fiom  rad  of  memory) 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  fimctira  number 

Remarks:  The  allocation  strategy  tqrplies  to  all  programs. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  fiuiction. 
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Interrupt  21H,  function  58H,  sub-function  1  DOS 

Set  aiiocation  strategy  (Version  3  and  up) 

Defines  the  method  cunently  in  use  by  MS-DOS  for  allocating  blocks  of  memory. 
If  a  program  allocates  menuny  using  fimctimi  48H,  diffoent  inograms  in  mernmy 
may  already  have  memrny  Modes  assigned  to  them.  Since  these  requested  memory 
blocks  vary  in  size,  DOS  has  three  methods  of  allocating  memory  to  a  jMOgram: 

•  First  fit:  DOS  starts  searching  at  the  start  of  memory  and  allocates  the 
first  memory  block  it  finds  of  the  requested  size; 

•  Best  fit*  DOS  searches  all  available  memwy  blocks  and  allocates  the 
smallest  suitable  memory  block  it  finds  (the  most  efficirat  method; 

•  Last  fit:  DOS  starts  searching  at  the  «id  of  memory  and  allocates  the  first 
memory  block  it  finds  of  the  requested  size. 

Input:  AH=:  S8H 

AL=  1 

BX=  Allocation  strategy 

BX=0:  First  fit  (start  firom  beginning  of  memory) 

BX=1:  Best  fit  (search  for  best-fitting  memory  block) 

BX=2:  Last  fit  (start  from  end  of  memory) 

Output:  Carry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function  number 

Remarks:  The  allocation  strategy  tqrplies  to  all  programs. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registm  are  not  affected  by  diis  function. 
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Interrupt  21H,  function  5911  DOS 

Get  extended  error  information  (Version  3  and  up) 


Gets  infonnation  about  enxirs  that  occur  during  the  call  of  one  of  the  functions  of 
either  interrupt  21H  or  interrupt  24H.  This  infonnation  includes  detailed 
infonnation  about  the  error,  its  origin  and  the  action  the  user  should  take  to 
alleviate  the  error. 


Inpu(: 


Output: 


Ronarks: 


AH=  59H 
BX=  0 


AX=  Description  oror 
BH=  Cause  of  oror 
BL=  Recommoided  action 
CH=  Source  of  oior 


The  following  codes  describe  the  oion 


Code 

0: 

1: 

2: 

3: 

4: 

5: 

6: 

7: 

8: 

9: 

10: 

11: 

12: 

13: 

14: 

15: 

16: 

17: 

18: 

19: 

20: 

21: 

22: 

23: 

24: 

25: 


Error _ 

No  error 

Invalid  function  number 

File  not  found 

Path  not  found 

Too  many  files  open  at  once 

Access  doiied 

Invalid  handle 

Memory  control  block  destroyed 
Insufficient  memory 
Invalid  memory  address 
Invalid  environment 
Invalid  format 
Invalid  access  code 
Invalid  data 
Reserved 
Invalid  drive 

Current  directcxy  caimot  be  removed 
DifiToent  device 
No  additional  files 
Medium  write  protected 
Unknown  device 
Device  not  ready 
Unknown  command 
CRC  error 

Bad  request  structure  length 
Sedrerror  ^ 
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Code  Error _ 

26:  Unknown  medium  type 

27 :  Sector  not  found 

28:  Printer  out  of  paper 

29:  Write  error 

30:  ReadOTor 

31:  General  failure 

32:  Sharing  violation 

33:  Lock  violation 

34:  Unauthorized  disk  change 

35:  FCB  not  available 

80:  File  already  exists 

81:  ResCTved 

82:  Directory  cannot  be  created 

83:  Terminate  after  call  of  interrupt  24H 

The  following  codes  describe  the  cause  of  the  error: 

Code _ Error _ _ _ 

1 :  No  memory  available  on  the  medium 

2:  Temporary  access  problem-may  end  soon 

3 :  Access  unauthoriz^ 

4 :  Internal  error  in  system  software 

5:  Hardware  OTor 

6:  Software  failure  not  caused  by  running  application  program 

7 :  Application  program  error 

8:  File  not  found 

9:  Invalid  file  format/type 

10:  File  locked 

1 1 :  Wrong  medium  in  drive,  bad  disk  or  medium  problem 

12:  Other  error 

The  following  codes  describe  the  action  needed  to  fix  the  error 

Code  Error _ 

1 :  Repeat  process  several  times,  then  ask  user  to  abort^gnore 

2:  Repeat  process  several  tirhes  pausing  each  time,  then  ask 

user  to  abort/ignore 

3:  Ask  user  for  correct  information  (e.g.,  filename) 

4:  Terminate  program  as  completely  as  possible 

5:  Terminate  program  NOW  (no  file  closing,  etc.) 

6:  Ignore  error 

7:  Ask  user  to  remove  error  source  and  repeat  process 
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The  fdlowing  codes  describe  the  source  of  the  etron 


1:  Unknown 

2:  Bkx:k  device  (disk  drive,  hard  disk,  etc.) 

3:  Netwoik 

4:  Soial  device 

5:  RAM 

The  contents  of  the  CS,  DS,  SS  and  ES  legists  are  not  affected  by  this 
function.  All  otho*  regista  contents  are  destroyed. 

Interrupt  21H,  function  5AH  DOS 

Create  temporary  file  (handle)  (Version  3  and  up) 

Creates  a  temporary  ff  le  in  memory  for  storage  during  program  execution.  The 
filename  doesn't  matter  because  the  access  occurs  through  the  assigned  handle. 
Since  this  function  allows  several  files  open  at  the  same  time,  DOS  creates 
fil^iames  from  the  current  date  and  time.  Every  temporary  file  is  ensured  its  own 
particular  name  because  the  functimi  cannot  be  called  mme  than  once  at  a  time. 

Input:  AH=  5AH 

CX=  File  attribute 

DS=  Diiectory  segment  address 

DX=  Diiectory  offset  address 

Output*  Carry  flag=0: 0.K. 

AX=Handle 

DS=Complete  filename  segment  address 
DX=Complete  filename  offset  address 
Carry  flag=l:  Enxa:  (AX  =  Error  code) 

AX=3:  Path  not  found 
AX=S;  Access  doiied 

Remarks:  The  directory  name  passed  is  an  ASCII  string  which  is  terminated  by  an 

end  chaiacto’  (ASCII  code  0).  It  can  contain  a  path  designation  and  drive 
specifier.  No  wildcards  are  allowed.  If  no  drive  specifier  or  path 
designation  exists,  the  function  accesses  the  current  drive  or  diiectory. 

The  bits  of  the  file  attribute  have  the  following  meanings: 

Bit  0  =  1:  Read  only  file 
Bit  1  =  1:  Hidden  file 
Bit  2=1:  System  file 

Temporary  files  are  not  automatically  deleted  after  program  execution. 
The  file  must  be  closed  using  functi(Mi  3EH,  then  the  temporary  file  must 
be  deleted  using  function  41H. 
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The  contents  of  the  BX,  CX,  DX,  SI.  DI,  BP,  CS,  DS,  SS  and  ES 
legistos  are  not  affected  by  this  function. 

Interrupt  21H,  function  5BH  DOS 

Create  new  file  (handle)  (Version  3  and  up) 

Creates  a  file  in  the  specified  directory  based  iqxxi  an  ASCII  file  fonnaL  If  no  drive 
specifier  or  path  is  provided,  the  file  opens  in  the  default  (current)  diiectcay. 

Input:  AH  =  SBH 

CX=  File  attributes: 

CX=00:  Normal  file 
CX=01:  Read-only  file 
CX=02:  Hidden  file 
CX=04:  System  file 

DS=  ASCn  file  specification  segment  address 
DX=  ASCn  file  specification  offset  address 

OuQrut:  Carry  flag3=0  (AX=  file  handle) 

Cany  flag=l  (AX  =  EnOT  code) 

AX=3:  Path  not  found 
AXa4:  No  handle  available 
AX=S:  Access  denied 
AX=80  (50H):  File  already  exists 

Remarks:  An  error  occurs  when  any  element  of  the  path  designation  doesn't  exist, 

when  the  filename  already  exists  in  the  specified  directory,  or  when  an 
attempt  is  made  to  create  the  file  in  an  alre^y  full  root  directory. 

The  file  defaults  to  the  normal  readAmte  attribute,  which  allows  both  read 
and  write  operations.  This  attribute  can  be  changed  by  using  function 
43H. 

Interrupt  21H,  function  5CH  DOS 

Control  record  access  (Version  3  and  up) 

Locks  or  unlocks  a  particular  section  of  a  file.  This  function  operates  on 
multitasking  and  networking  systems. 

Input:  AH=  5CH 

AL=  Function  code 

AL=00:  Lock  file  section 
AL=01:  Unlock  file  section 
BX=  File  handle 
CX=  High  word  of  section  offset 
DX=  Low  word  of  section  offset 
SI  =  High  word  of  section  length 
DI  =  Low  word  of  section  length 
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Output:  Carry  flag=0:  Successful  lock/unlock 

Carry  flag=l:  Error  (AX  =  Ecrh' code) 

AX=1:  bivalid  ftinction  code 
AX=6:  bivalid  handle 

AX=33  (21H):  All  or  part  of  section  already  locked 

Ronaiks:  This  function  can  only  be  used  on  files  already  tqtened  or  created  using 

functions  3CH.  3DH.  5AH  or  5BH. 

The  ccHiesponding  call  to  unlock  a  file  region  must  contain  the  identical 
file  offset  and  file  regioi  length. 

Interrupt  21H,  function  5EH,  sub-function  0  DOS 

Get  machine  name  (Version  3.1  and  up) 

Returns  the  address  of  an  ASCII  string  which  defines  the  Ideal  compute  type 
within  a  network. 

Input:  AH=  5EH 

AL=  00 

DS=  User  buffo*  segment  address 
DX=  User  buffo*  offset  address 

OuQtut:  Carry  flag=0:  Successful  execution 

CH=  00:  Name  undefined 
CH>  00:  Name  defined 

CL=  NETBIOS  name  numbo  (when  CHoOO) 

DS=  Identifio  segment  address  (when  CHoOO) 

DX=  Identifio  offset  address  (when  CHoOO) 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function  code 

Remarks:  The  conputer  type  is  a  IS-byte-loig  string  to'minated  by  an  end  character 

(ASen  code  0). 

Interrupt  21H,  function  5EH,  sub-function  2  DOS 

Set  printer  setup  (Version  3.1  and  up) 

Specifies  a  string  which  precedes  all  ouQmt  to  a  particular  printer  used  by  a 
network.  This  string  allows  netw(»k  users  to  assign  their  own  individual  printing 
parameters  to  the  shared  prints*. 

Input:  AH=  5EH 

AL=  02 

BX  =  Redirection  list  index  (see  Remarks  below) 

CX=  Printer  setup  string  length 
DS=  Prints  setup  string  segment  address 
SI  =  Printo*  setup  string  offset  address 
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C>uQ)ut:  Cany  flag=0:  Successful  execution 

Cany  flag=l:  Bror  (AX  =  Enw  code) 

AX=1:  Invalid  fimction  code 

Remarks:  The  contents  oi  register  BX  (redirection  list  index)  come  firom  function  94 

5EH,  sub-function  2.  Function  5EH,  sub-function  3  (see  below)  can 
suiqriy  the  current  inintn'  setup  string. 

Interrupt  21H,  function  5EH,  sub-function  3  DOS 

Get  printer  setup  (Version  3.1  and  up) 

Gets  the  printer  setup  string  assigned  to  a  particular  network  printer  by  using 
function  SEH,  sub-function  2  (see  above). 

Input:  AH  =  SEH 

AL=  03  ^ 

BX=  Redirection  list  index) 

DS  =  Setup  string  receiving  buffo*  segment  address 
SI=  Setup  string  receiving  buffo  offset  address 

Output:  Cany  flag=0:  Successful  execution 

CX=Printer  setup  string  length 
ES=Segment  address  of  buffer  retaining  setiQ)  string 
DI=Offset  address  of  buffo  retaining  setiq>  siring 
Cany  fl^l:  Error  (AX  s  Error  code) 

AX=1:  hivalid  fiuKtion  code 

Remarirs:  The  contents  of  register  BX  (redirection  list  index)  come  from  function 

SEH,  sub-function  2.  Function  SEH,  sub-function  3  can  supply  the 
current  printo  setup  string. 

Interrupt  21H,  function  5FH,  sub-function  2  DOS 

Get  redirection  list  entry  (Version  3.1  and  up) 

Gets  the  system  redirection  list  This  list  assigns  local  names  to  netwok  printers, 
files  o  directories. 

Input:  AH=  SFH 

AL=  02 

BX=  Redirection  list  index  (see  Remarks  below) 

DS=  Device  name  buffo  segment  address  (16  bytes) 

SI  =  Device  name  buffo  offset  address  (16  bytes) 

ES=  Network  name  buffo  segment  add^  (128  bytes) 

DI=  Network  name  buffo  offset  address  (128  bytes) 
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Ouq>ut:  Cany  flag=0:  Successful  execution 

BH=  Status  flag 
0:  Valid  device 
1:  Invalid  device 
BL=  Device  type 
3:  Printer 
4:  Drive 
BP  =  Destroyed 

CX=  Parameter  value  in  menMHy 
DX=  Destroyed 

DS=  ASCn  format  local  device  name  segment  address 
SI=  ASCII  format  local  device  name  offset  address 
ES=  ASCn  format  network  name  segment  address 
DI  =  ASCn  format  network  name  c^set  address 
Cany  flag=l:  Error  (AX  s  Error  code) 

AX=1:  Invalid  function  code 
AX=18:  No  more  fUes  avail^le 

Remarks:  The  contents  of  regist^  CX  come  from  function  5FH,  sub-function  3  (see 

below). 

Interrupt  21H,  function  5FH,  sub-function  3  DOS 

Redirect  device  (Version  3  and  up) 

Redirects  device  access  in  a  network,  assigning  a  network  name  to  a  local  device. 

Input:  AH=  5FH 

AL=  03 

BL=  Device  type 
BL=3:  Printer 
BL=4:  Drive 

CX=  Parameter  value  in  memory 

DS=  ASCn  format  local  device  name  segment  address 

SI=  ASCn  format  local  device  name  offset  address 

ES  =  ASCn  format  network  name  and  password  segment  address 

DI=  ASCn  format  netw(»k  name  and  password  offset  address 

Output:  Carry  flag=0:  Successful  execution 

Carry  flag=l:  Ettm-  (AX  =  Error  code) 

AX=1:  Invalid  function  code;  string  format  incorrect; 

device  redirected 
AX=3:  Path  not  found 
AX=S:  Access  denied 
AX=8:  Insufficient  memory 

Rmarks:  The  contents  of  register  CX  are  siqrplied  from  function  SFH,  sub-function 

3. 

Device  names  can  be  drive  specifiers  (e.g..  A:),  printer  names  (i.e.,  LPTl, 
PRN,  LPT2  or  LPT3)  or  null  strings.  If  you  enter  a  null  string  and  pass- 
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wwd  as  the  device  name,  DOS  tries  to  open  access  to  the  netwcni:  using 
die  password. 

Interrupt  21H,  function  5FH,  sub-function  4  DOS 

Cancei  redirection  (Version  3  and  up) 

Disables  the  current  redirection  by  removing  iocal  name  assignments  to  network 
printers,  files  or  directories. 

Input:  AH  =  SFH 

AL=  04 

BXs  Redirection  list  index  (see  Remarks  below) 

DS=  ASCn  format  local  device  name  segment  address 
SI  =  ASCn  format  local  device  name  of^  address 

Output:  Cany  flag=0:  Successful  execution 

Cany  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function  code;  device  name  not  on  network 
AX=1S:  Redirection  halted 

Remarirs:  Device  names  can  be  drive  specifiers  (e.g..  A:),  printer  names  (i.e.,  LPTl, 

PRN,  LPT2  or  LPT3)  or  strings  begiruiing  wiA  double  backslashes  (i.e., 
W).  A  string  preceded  by  two  backslashes  terminates  communications 
betwe^  the  local  computer  and  the  network. 

Interrupt  21H,  function  62H  DOS 

Get  PSP  address  (Version  3  and  up) 

Gets  the  segment  address  of  the  PSP  from  the  currently  executing  program. 

Input:  AH=  62H 

Output:  BX=  PSP  segment  address 

Remarks:  The  PSP  starts  at  address  BX:(XXX). 

The  contents  of  the  AX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS,  ES  registos 
and  the  flag  registers  are  not  affect^  by  this  function. 
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Interrupt  21H,  function  63H,  sub-function  0  DOS 

Get  lead  byte  table  (Version  2.25  only) 

Gets  the  address  of  the  system  table  which  defines  the  byte  ranges  for  the  PC's 
extended  character  sets. 

Input:  AH=  9963H 

AL  =  00:  Get  address  of  system  lead  byte  table 

Output:  DS=  Table  segment  address 

SI  =  Table  offset  address 

Remaiks:  This  function  is  available  only  in  DOS  Version  2.25. 


Interrupt  21H,  function  63H,  sub-function  1  DOS 

Set  or  clear  interim  console  flag  (Version  2.25  only) 

Clears  the  interim  console  flag. 

Input:  AH=  63H 

AL  =  01:  Clear  or  set  interim  console  flag 
DL=  Interim  console  flag  setting 
DL=01:  Set  interim  console  flag 
DL=00:  Clear  interim  console  flag 

Output:  No  output 

Remarks:  This  function  is  available  only  in  DOS  Version  2.25. 


Interrupt  21H,  function  63H,  sub-function  2  DOS 

Get  interim  console  flag  (Version  2.25  only) 

Gets  the  interim  console  flag. 

Input:  AH=  63H 

AL  =  02:  Get  interim  console  flag  value 

Output:  DL  =  Flag  value 

Remarks:  This  function  is  available  only  in  DOS  Version  2.25. 


Interrupt  21H,  function  64H 
Reserved 


DOS 

(Version  3  and  up) 


Interrupt  21H,  function  65H  DOS 

Get  extended  country  information  (Version  3.3  and  up) 

Gets  information  about  the  specific  country/code  page. 


Input:  AH=  65H 

AL=  sub-function: 

AL  =  1:  Get  international  information 
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Output: 

Remarks: 


AL  =  2:  Get  uppercase  pointer  table 

AL  =  4:  Get  pointer  to  uppercase  pointer  table  (filename) 

AL  =  6:  Get  pointer  to  collation  table 
BX=  Codepage: 

BX  =  -1:  active  CON  device 

CX=  Length  of  buffer  allocated  to  receive  information 
DX=  Country  ID  number 
DX  =  -1:  Default 

ES:DI  =  Address  of  buffer  allocated  to  receive  information 

Carry  flag=0:  Successful  execution 
Carry  flag^l:  Error  (AX  =  Error  code) 

The  information  this  function  returns  is  an  extended  version  of  the 
information  returned  by  int  21H,  function  38H. 

An  error  may  occur  if  the  country  code  in  DX  is  invalid,  or  if  the  code 
page  number  is  different  from  the  country  code,  or  if  the  buffer  length 
specified  in  the  CX  register  is  less  than  five  bytes.  If  the  buffer  is  not 
long  enough  to  receive  all  the  information,  the  function  accepts  as  much 
information  as  the  buffer  will  accept.  This  buffer  contains  the  following 
information  after  the  call: 

Byte  0:  ID  code  for  information 
Bytes  1-2:  Length  of  buffer 
Bytes  3-4:  Country  ID 
Bytes  5-6:  Code  page 
Bytes  7-8:  Date  format 
0  =  USA:  Month-day-year 

1  =  Europe:  Day-mondi-year 

2  =  Japan:  Year-month-day 
Bytes  9-13:  Currency  indicator 

Bytes  14-15:  ASCII  code  of  the  thousand  character  (comma/period) 

Bytes  16-17:  ASCII  code  of  the  decimal  character  (period/comma) 

Bytes  18-19:  ASCII  code  of  the  date  separation  character 

Bytes  20-21:  ASCII  code  of  the  time  separation  character 

Byte  22:  Currency  format 

bit  0  =  0:  Currency  symbol  before  the  value 

bit  0=1:  Currency  symbol  after  the  value 

bit  1  =  0:  No  spaces  between  value  and  currency  symbol 

bit  1  =  1:  Space  between  value  and  currency  symbol 

Byte  23:  Precision  (number  of  decimal  places) 

Byte  24:  Time  format 
bit  0  =  0:  12-hour  clock 
bit  0=1:  24-hour  clock 

Bytes  25-28:  Address  of  character  conversion  routine 
Bytes  29-30:  ASCII  data  separator 
Bytes  31-40:  Reserved 
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Interrupt  21H,  function  66H 
Get  or  set  code  page 

Gets  or  sets  the  current  code  page. 

Input:  AH=  66H 

AL=  sub-function: 

AL  =  1:  Get  code  page 
AL  =  2:  Select  code  page 
BX=  Selected  code  page  (if  AL  =  2) 

Output:  Carry  flag=0:  Successful  execution 

If  AL  =1  used  for  input: 

BX  =  active  code  page 
DX  =  default  code  page 
Carry  flag=l:  Error  (AX  =  Enor  code) 

Remaiks:  If  sub-function  2  is  used,  COUNTRY.SYS  supplies  the  code  page 

number. 

The  DEVICE...  (CONFIG.SYS),  NLSFUNC  and  MODE  CP  PREPARE 
commands  (AUTOEXEC.BAT)  must  have  already  configured  the  system 
for  code  page  switching  before  this  function  may  be  called. 

Interrupt  21H,  function  67H  DOS 

Set  handle  count  (Version  3.3  and  up) 

Sets  the  maximum  number  of  accessible  files  and  devices  that  may  be  currently 
opened  using  handles. 

Input:  AH=  67H 

BX=  Number  of  handles  desired 

Output:  Carry  flag=0:  Successful  execution 

Carry  flags=l:  Error  (AX  =  Error  code) 

Remarks:  The  PSP’s  default  table  reserved  for  the  process  can  control  20  handles. 

An  error  occurs  if  the  content  of  the  BX  register  is  greater  than  20,  or  if 
insufficient  memory  exists  to  allocate  a  block  for  the  extended  table. 

If  the  number  in  the  BX  register  is  greater  than  the  number  of  entries 
assigned  by  the  FILES  entry  in  the  CONFIG.SYS  file,  no  error  occurs. 
However,  attempts  at  opening  a  file  or  device  fail  if  all  file  entries  are  in 
use,  even  if  file  handles  are  still  available. 

Interrupt  21H,  function  68H  DOS 

Commit  file  (Version  3.3  and  up) 

Writes  all  DOS  buffers  associated  to  a  specific  handle  to  the  specified  device.  If  the 
handle  points  to  a  file,  the  file’s  contents,  date  and  size  are  updated. 


DOS 

(Version  3.3.  and  up) 
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AH=  68H 
BX=  File  handle 

Carry  flag=0:  Successful  execution 
Carry  flag=l:  Error  (AX  =  Error  code) 

This  function  performs  the  same  task  as  closing  and  reopening  a  file  or 
duplicate  handle,  even  without  handles.  If  this  function  accesses  a 
character  device's  handle,  the  carry  flag  returns  0  but  nothing  else 
h^pens. 

Multiprocessing  and  networking  applciations  maintain  control  of  the  tile. 

Interrupt  22H  DOS 

Terminate  address  (Version  1  and  up) 

Contains  the  address  of  a  routine  which  terminates  a  program.  Control  returns  to 
the  program  that  called  for  termination.  You  should  never  call  this  routine  directly. 

DOS  stores  the  contents  of  this  interrupt  vector  in  the  PSP  of  the  program  to  be 
executed  before  passing  control  to  the  program.  This  prevents  program  changes  to 
the  vector,  which  could  prevent  DOS  from  calling  the  termination  routine. 

Interrupt  23H  DOS 

<Ctrl><C>  handler  address  (Version  1  and  up) 

Contains  the  address  of  a  routine  which  executes  when  the  user  presses  <Ctrl><C> 
or  <Ctrl><Break>.  You  should  never  directly  call  this  routine. 

DOS  stores  the  contents  of  this  interrupt  vector  in  the  PSP  of  the  program  to  be 
executed  before  passing  control  to  the  program.  This  prevents  program  changes  to 
the  vector,  which  could  prevent  DOS  from  calling  the  termination  routine. 


Input: 

Output: 

Remaiks: 


Interrupt  24H  DOS 

Critical  error  handler  address  (Version  1  and  up) 


Represents  a  routine  called  during  hardware  access  (e.g.,  disk  drive)  when  a  critical 
error  occurs.  You  should  never  directly  call  this  routine. 

When  an  application  routine  is  called  during  a  critical  error,  bit  7  of  the  AH 
register  indicates  the  type  of  failure  (0  =  disk/hard  disk  error,  1=  other  errors).  A 
disk/hard  disk  error  will  only  be  reported  after  several  attempted  accesses.  During 
the  call,  the  DI  register  receives  one  of  the  following  codes: 

0:  Disk  write  protected 

1 :  Access  on  unknown  device 

2:  Drive  not  ready 

3:  Invalid  command 

4:  CRC  eiTOT 

5 :  Bad  request  structure  length 

6:  Seek  OTor 

7:  Unknown  device  type 
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8:  Sector  not  found 

9:  Printer  out  of  paper 

10:  Write  error 

11:  ReadOTor 

12:  General  failure 

The  error  routine  restores  the  SS,  SP,  DS,  ES,  BX,  CX  and  DX  registers  to  the 
same  values  that  they  contained  during  the  call.  During  execution  it  can  only 
access  functions  1  to  OCH  of  interrupt  21H.  It  should  be  terminated  by  an  IRET 
instruction  and  pass  one  of  the  following  codes  to  the  AL  register: 

0:  Ignore  eira* 

1 :  Repeat  the  operation 

2:  Terminate  program  using  interrupt  23H 

3:  Fail  system  call  (Version  3  and  up  only) 

If  a  program  changes  the  content  of  this  interrupt  vector,  the  program  can 
terminate  without  restoring  the  memory  contents.  Since  RAM  can  be  released  and 
used  by  other  programs,  the  critical  error  routine  can  be  overwritten  by  another 
program  in  memory.  When  this  occurs,  a  critical  error  could  cause  a  system  crash 
because  a  completely  different  code  now  exists  at  the  location  of  the  old  error 
handler  routine. 

Before  passing  control  to  the  program,  DOS  stores  the  contents  of  this  interrupt 
vector  in  the  PSP  of  the  program  to  be  executed.  This  prevents  program  changes 
to  the  vector,  which  could  prevent  DOS  from  calling  the  termination  routine. 
During  program  termination,  the  contents  of  the  interrupt  vector  pass  from  the 
PSP  to  the  vector;  then  the  system  calls  the  routine. 


Interrupt  25H  DOS 

Absolute  disk  read  (Version  1  and  up) 

Reads  one  or  more  consecutive  sectors  from  a  disk  or  hard  disk. 


Input: 


Output: 


AL=  Drive  specifier 
CX=  Number  of  sectors  to  read 
DX=  Fiist  sector  to  read 
DS=  Buffo  segment  address 
BX=  Buffer  offset  address 

Carry  flag=0: 0.K. 

Carry  flag=l:  Error  (AX  =  Error  code) 
AX=1:  Bad  command 
AX=2:  Bad  address 
AX=4:  Sector  not  found 
AX=8:  DMA  error 
AX=16:  CRC  error 
AX=32:  Disk  controller  error 
AX=64:  Seek  error 
AX=128:  Device  does  not  respond 


844 


Abacus 


Appendix  C:  DOS  Interrupts  and  Functions 


Remaiks:  In  the  AL  register  0  represents  drive  A:,  1  represents  drive  B:,  etc. 

All  the  sectors  of  the  medium  can  be  accessed.  DOS  itself  uses  this 
interrupt  to  read  the  root  directory  and  the  FAT  of  a  medium.  The  data  are 
read  from  the  medium  into  the  buffer  of  the  calling  program.  After  the 
function  call,  the  contents  of  all  registers,  except  the  segment  register, 
may  change. 

After  the  interrupt  call,  the  stack  pointer  changes  position  because  two 
bytes  stored  on  the  stack  during  the  call  are  removed  and  not  returned. 
TTiese  bytes  represent  the  flag  register,  which  can  be  read  from  the  stack 
using  the  POPF  instruction.  ITie  old  v^ue  of  the  stack  pointer  can  be  set 
by  adding  2  to  its  contents.  If  you  omit  the  stack  pointer  correction,  the 
stack  could  overflow.  Because  of  this,  you  cannot  call  this  interrupt  from 
higher  level  languages.  You  must  call  it  from  assembly  language. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 


Interrupt  26H  DOS 

Absolute  disk  write  (Version  1  and  up) 

Writes  one  or  more  consecutive  sectors  to  a  disk  or  hard  disk. 

Input:  AL  =  Device  designation 

CX=  Number  of  sectors  to  be  written 
DX=  First  sector  to  be  written 
DS  =  Buffer  segment  address 
BX=  Buffer  offset  address 

Output:  Carry  flag=0:  O.K. 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Bad  command 

AX=2:  Bad  address 

AX=3:  Medium  write  protected 

AX=4:  Sector  not  found 

AX=8:  DMA  error 

AX=16:  CRC  error 

AX=32:  Disk  controller  error 

AX=64:  Seek  error 

AX=128:  Device  does  not  respond 

Remarks:  In  the  drive  specifier  0  represents  drive  A:,  1  represents  drive  B:,  etc. 

All  the  sectors  of  the  medium  can  be  accessed.  DOS  itself  uses  this 
interrupt  to  write  the  root  directory  and  the  FAT  to  a  medium.  The  data 
are  written  from  the  buffer  of  the  calling  program  to  the  medium.  After 
the  function  call,  the  contents  of  all  registers,  except  the  segment  register, 
may  change. 
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After  the  interrupt  call,  the  stack  pointer  changes  position  because  two 
bytes  stored  on  the  stack  during  the  call  are  removed  and  not  returned. 
These  bytes  represent  the  flag  register,  which  can  be  read  from  the  stack 
using  the  POPF  instruction.  The  old  value  of  the  stack  pointer  can  be  set 
by  adding  2  to  its  contents.  If  you  omit  the  stack  pointer  correction,  the 
stack  could  overflow.  Because  of  this,  you  cannot  call  this  interrupt  from 
higher  level  languages.  You  must  call  it  from  assembly  language. 

The  contents  of  the  BX,  CX,  DX,  SI,  DI,  BP,  CS,  DS,  SS  and  ES 
registers  are  not  affected  by  this  function.  The  contents  of  all  other 
registers  may  change. 


Interrupt  27H  DOS 

Terminate  and  stay  resident  (Version  1  and  up) 

Terminates  the  currently  executing  program  and  returns  control  to  the  program  that 
called  the  current  program.  Unlike  other  functions  used  for  program  termination, 
the  memory  used  by  the  current  program  keeps  the  program  code  for  later  recall. 

Input:  CS  =  PSP  segment  address 

DX  =  Number  of  bytes  +  1  to  be  reserved 

Output:  No  output 

Remarks:  This  function  is  only  suitable  for  calling  COM  programs. 

The  number  of  bytes  to  be  reserved  relates  to  the  beginning  of  the  PSP. 

The  value  in  the  DX  register  has  no  effect  on  memory  blocks  reserved  by 
function  48H  of  interrupt  21H. 

An  error  occurs  during  the  call  of  this  interrupt  if  the  value  in  the  DX 
register  ranges  from  FFFIH  to  FFFETI. 

This  interrupt  does  not  close  open  files. 

Interrupt  2FH,  sub-function  0  DOS 

Get  print  spool  install  status  (Version  3  and  up) 

Gets  current  installation  status  of  the  print  spooler. 

Input:  AH=  2FH 

AL=  0 

Output:  Carry  flag=0:  Successful  execution 

AL=  0:  O.K.  to  install 
AL=  1:  I>on't  install 
AL  =  255:  Already  installed 
Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function 
AX=2:  File  not  found 
AX=3:  Path  not  found 
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AX=4:  Too  many  files  currently  open 
AX=5:  Access  denied 
AX=8:  Print  queue  full 
AX=9:  Print  spooler  busy 
AX=12:  Name  too  long 
AX=15:  Invalid  drive 

Interrupt  2FH,  sub-function  1 

Send  file  to  print  spooler 

Passes  a  file  to  the  print  spooler. 

Input:  AH=  2FH 

AL=  1 

DS  =  Print  packet  (see  below)  segment  address 
DX  =  Print  packet  (see  below)  offset  address 

Output:  Carry  flag=0:  Successful  execution 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function 

AX=2:  File  not  found 

AX=3:  Path  not  found 

AX=4:  Too  many  files  currently  open 

AX=5:  Access  d^ied 

AX=8:  Print  queue  full 

AX=9:  Print  spooler  busy 

AX=12:  Name  too  long 

AX=15:  Invalid  drive 

Remarks:  The  five-byte  print  packet  contains  print  spooler  information.  The  first 

byte  indicates  the  DOS  version  (0=Versions  3.1  to  3.3);  the  remaining 
bytes  indicate  the  segment  and  offset  addresses  of  the  file  specification. 

Interrupt  2FH,  sub-function  2  DOS 

Remove  file  from  print  queue  (Version  3  and  up) 

Deletes  a  file  from  the  print  spooler  queue. 

Input:  AH=  2FH 

AL=  2 

DS  =  ASCII-format  file  segment  address 

DX  =  ASCII-format  file  offset  address 

Output:  Carry  flag=0:  Successful  execution 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function 

AX=2:  File  not  found 

AX=3:  Path  not  found 

AX=4:  Too  many  files  currently  open 

AX=5:  Access  denied 

AX=8:  Print  queue  full 


DOS 
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AX=9:  Print  spooler  busy  ^ 

AX=12:  Name  too  long 
AX=15:  Invalid  drive 

Remaiks:  This  sub-function  allows  wildcards  (?  and  *)  in  file  specifications, 

allowing  you  to  delete  more  than  one  file  at  a  time  from  the  print  queue. 

Interrupt  2FH,  sub-function  3  DOS 

Cancel  all  files  in  print  queue  (Version  3  and  up) 

Cancels  all  files  waiting  in  the  print  spooler  queue  for  printing. 

Input:  AH=  2FH 

AL=  3 

Output:  Carry  flag=0:  Successful  execution 

Carry  flag=l:  Error  (AX  =  Error  code) 

AX=1:  Invalid  function 

AX=2:  File  not  found 

AX=3:  Path  not  found 

AX=4:  Too  many  files  currently  open 

AX=5:  Access  denied 

AX=8:  Print  queue  full 

AX=9:  Print  spooler  busy 

AX=12:  Name  too  long 

AX=15:  Invalid  drive 

Interrupt  2FH,  sub-function  4 

Hold  print  jobs  for  status  check 

Halts  all  print  jobs  while  testing  for  spooler  status. 

Input:  AH=  2FH 

AL=  4 

Output:  Carry  flag=0:  Successful  execution 

Carry  flag=l:  Error 
DX=  Number  of  errors 
DS  =  Print  queue  segment  address 
SI  =  Print  queue  offset  address 

Remarks:  The  print  queue  segment  and  offset  addresses  point  to  a  set  of  64-byte 

filenames  in  the  queue.  Each  entry  contains  an  ASCII  file  specification. 

The  first  filename  in  the  queue  is  the  file  currently  printing  in  the  print 
spooler.  The  last  filename  in  the  queue  has  a  zero  in  the  first  byte  of  the 
specification.  / 
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Interrupt  67H,  function  IH  LIM/EMS 

Extended  memory:  Get  status 

Returns  the  error  status  of  die  EMM  after  calling  any  EMS  functions. 

Input  AH=  40H 

Output  AH  =  EMM  status 

AH=OOH:  O.K. 

AH=80H:  Internal  error,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  error 

Remarks:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

corresponding  EMM  are  installed  (see  Cluqpter  13  for  more  information). 
This  function  should  be  the  first  EMM  call  a  program  makes,  to  ensure 
diat  the  hardware  and  software  are  functioning  inqperly. 

Interrupt  67H,  function  2H  LIM/EMS 

Extended  memory:  Get  segment  address  of  the  page  frame 

Determines  the  segment  address  of  the  page  frame. 

Input:  AH=  41H 

Output:  AH=  0:  O.K. 

BX=  Page  frame  segment  address 
AH>  0: Error 

AH=80H:  Internal  oror,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  error 

Remarks:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

corresponding  EMM  are  installed  (see  Ctu^r  13  for  more  information). 
The  addresses  of  the  four  physical  pages  can  be  calculated  from  this 
segment  address,  whereby  the  first  page  starts  at  address 
PAGE_FRAME:0000.  The  three  otho:  pages  follow  at  16K  intavals. 
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Interrupt  67H,  function  3H  LIM/EMS 

Extended  memory:  Get  number  of  EMS  pages 

Informs  the  calling  program  how  many  16K  EMS  pages  are  installed,  and  how 
many  EMS  pages  are  still  available  or  imallocated. 

Input:  AH  =  42H 

Output  AH=  0:  O.K. 

BX=  Numbo*  of  fiee  (unallocated)  pages 
DXs  Total  number  of  EMS  pages 
AH>  0: Error 

AH=80H:  Internal  orw,  EMM  possibly  destroyed 
AH=s81H:  EMS  hardware  error 

Remarks:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

corresponding  EMM  are  installed  (see  Chapter  13  for  more  information). 

The  number  of  kilobytes  of  free  EMS  memory  can  be  calculated  by 
multiplying  the  number  of  free  pages  by  16. 

Interrupt  67H,  function  4H  LIM/EMS 

Extended  memory:  Allocate  EMS  memory 

Allocates  a  given  number  of  16K  EMS  pages  fcx*  lat^  access. 

Input  AH=  43H 

BX=  Number  of  logical  (16K)  pages  to  be  allocated 

AH=  0:  O.K. 

DX=  Handle  for  accessing  allocated  memory 
AH>  9:  Error 

AH=80H:  Internal  error,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  mor 
AH=8SH:  No  mote  handles  available 
AH=87H:  Not  enough  pages  free 
AH=88H:  No  pages  w«e  requested 

Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 
cmesponding  EMM  are  installed  (see  Cluq)t»’  13  frx  mwe  information). 

The  handle  returned  can  be  used  fm'  future  access  and  for  releasing  the 
allocated  memory.  If  this  handle  is  "lost”,  the  handle  cannot  be  recov^ed, 
nor  can  memory  be  released  or  used  by  olhar  programs. 

A  call  to  this  functim  may  fail  because  there  are  not  enough  pages  firee  or 
because  the  EMM  has  b^n  called  so  often  that  no  more  handles  are 
available. 

The  handles  normally  have  the  numbers  FFOOH,  FEOIH,  FD02H, 
FC03H,  etc. 
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Interrupt  67H,  function  5H  LIM/EMS 

Extended  memory:  Set  mapping 

Places  one  of  the  pages  previously  allocated  by  function  4H  in  tme  of  the  four 
physical  pages  within  the  page  frame. 

AHs  44H 

AL=  Physical  page  numbo' (0  to  3) 

BX=  Logical  page  number 
DX=  Handle 

AHs  Error  status 
AH=00H:  O.K. 

AH=80H:  Internal  arm,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  arm 
AH=83H:  Invalid  hatKile 
AH=8AH:  Invalid  logical  page 
AH=8BH:  Invalid  physical  page 

Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 
corresponding  EMM  are  installed  (see  Chig)ter  13  for  more  information). 

The  handle  used  whoi  calling  this  function  must  have  been  returned  by  a 
previous  call  to  EMM  function  4H. 

The  logical  pages  are  numbered  from  0  on,  so  that  the  value  0  must  be 
passed  to  access  the  first  logical  page.  The  largest  value  allowed  is  the 
numbo'  of  allocated  pages  minus  one. 

Befrne  accessing  the  physical  page,  the  segment  address  of  the  page  frame 
must  be  determined  with  function  2H. 

Interrupt  67H,  function  6H  LIM/EMS 

Extended  memory:  Release  pages 

Releases  pages  allocated  with  function  4H  to  the  EMM.  This  makes  these  pages 
available  to  otha  qtplications. 

Input:  AH=  45H 

DX=  Handle 

Output:  AH=  Error  status: 

AH=00H:  O.K. 

AH=80H:  Internal  etTcx,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  arm 
AH=83H:  Invalid  handle 

AH=8SH:  Error  while  saving  and  resbxing  mapping 


Input: 


Output: 


Remarks: 
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Remailcs:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

coneqxmding  EMM  are  installed  (see  Clug)ter  13  for  more  infixmation). 

The  handle  used  when  calling  this  functkn  must  have  been  returned  by  a 
previous  call  to  EMM  function  4H. 

All  of  the  pages  allocated  to  diis  handle  are  released  by  this  function.  It  is 
impossible  to  release  individual  pages. 

After  a  successful  call  to  this  function  the  handle  is  no  longer  valid  and 
cannot  be  used  for  accessing  EMS  memory. 

If  the  function  returns  an  error,  you  should  repeat  the  call  at  least  three 
times  (x  the  pages  will  remain  allocated  and  will  not  be  available  for 
other  programs. 

Interrupt  67H,  function  7H  LIM/EMS 

Extended  memory:  Get  EMM  version 

Determines  the  versioi  number  of  the  EMM  (E^qxmded  Memory  Manago*). 

Input:  AH  =  46H 

OuQ>ut:  AH=  0:  O.K. 

AL=  EMM  vosirm  number 
AH>  0:  Error 

AH=80H:  hitemal  errrx,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  error 

R»narks:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

corresponding  EMM  are  installed  (see  Cbapter  13  for  more  infcxmation). 

The  EMM  version  numbo'  is  stored  in  the  AL  register  as  a  BCD  number, 
in  which  the  upper  four  bits  rejnesent  the  vision  number  preceding  the 
decimal  point  and  the  lower  four  bits  represent  the  vision  number 
following  the  decimal  point  See  also  the  demonstration  programs  in 
Chapter  13. 

Interrupt  67H,  function  8H  LIM/EMS 

Extended  memory:  Save  mapping 

Saves  current  m^ing  between  the  four  physical  pages  in  the  page  frame  and  the 
associated  logical  pages. 

Input:  AH=  47H 

DX=  Handle 
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C)uq;)ut:  AHs  Enorstatus 

AH=OOH:OJC. 

AH=80H:  Internal  mot,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  eaor 
AH=83H:  Invalid  handle 
AHsSCH:  Mapping  memory  fidl 

AH=8DH:  Mqq^g  hande  already  sttxed,  not  restored  using 
function  9H 

R^natks;  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

correqxmding  EMM  are  installed  (see  Giaptn  13  for  mote  infimrtation). 

The  handle  used  when  calling  this  function  must  have  been  returned  by  a 
previous  call  to  EMM  function  4H. 

This  function  is  intended  for  use  within  a  TSR  program  or  by  the 
operating  system  in  a  multitasking  environment,  but  can  be  used  by  any 
program. 


Interrupt  67H,  function  9H  LIM/EMS 

Extended  memory:  Restore  mapping 

Restores  nuqrping  between  the  logical  and  physical  pages  saved  by  function  8H. 

Input:  AH=  48H 

DX  =  Handle 

Output:  AH  s  Error  status: 

AH=(X)H:  O.K. 

AH=80H:  Internal  ottM',  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  oror 
AH=83H:  Invalid  handle 

AH=8EH:  Mt^rping  storage  contains  no  entry  for  this  handle 

Rmaiks:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

corresponding  EMM  are  installed  (see  Chapber  13  for  mote  information). 

The  handle  used  when  calling  this  function  must  have  been  returned  by  a 
previous  call  to  EMM  function  4H. 

Calling  this  function  fails  whenevo*  the  mapping  for  this  handle  has  not 
been  saved  widi  function  8H,  or  the  mapping  has  already  been  restored  by 
a  previous  call  to  function  9H. 

This  function  is  intended  for  use  within  a  TSR  program  or  by  the 
operating  system  in  a  multitasking  environment,  but  can  be  used  by  any 
program. 
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Interrupt  67H,  function  OCH  LIM/EMS 

Extended  memory:  Get  number  of  handles 

Returns  the  number  of  memtxy  blocks  and  the  number  of  handles  allocated  by 
function  4H. 

Input'  AH=  4BH 

Ou^ut:  AH=  0:  O.K. 

BX=  Numbered  allocated  handles 
AH>  OiEnor 

AH=80H:  hitemal  error,  EMM  possibly  destroyed 
AH=s81H:  EMS  hardware  oror 

Remarks:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

corresponding  EMM  are  installed  (see  Chapter  13  for  more  infexmation). 

The  number  of  allocated  handles  is  not  the  same  as  the  number  of 
programs  which  are  currratly  accessing  the  EMS  memory.  Each  (xogram 
can  request  an  arbitrary  number  of  EMS  memory  blocks/handles  with 
function  4H. 

Interrupt  67H,  function  ODH  LIM/EMS 

Extended  memory:  Get  number  of  allocated  pages 

Returns  the  number  of  pages  which  have  been  allocated  to  the  specified  handle. 

Input:  AH=  4CH 

DX=  Handle 

Ouq>ut:  AH  =  0:  O.K. 

BX=  Numba  of  allocated  pages 
AH>  0: Error 

AH=80H:  hitemal  mor,  EMM  possibly  destroyed 
AH=81H:  EMS  hardware  oror 
AH=83H:  hivalid  handle 

Remarks:  Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 

ctxresponding  EMM  are  installed  (see  Ch^ter  13  for  more  information). 

The  number  of  allocated  pages  must  range  from  1  to  512. 
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Interrupt  67H,  function  OEH  LIM/EMS 

Extended  memory:  Get  all  handles 

Loads  the  numbos  of  all  active  handles  and  the  niunba  of  pages  allocated  to  each 
into  an  anay. 


Input: 

AHs48H 

ES  =  Segment  address  of  array 

DI = OfEstt  address  of  array 

Output: 

AH  =  0: 0.K. 

BX  =  Numbo'  of  allocated  logical  pages 

AH>  0: Error 

AHsSOH:  Internal  oror,  EMM  possibly  destroyed 

AH=81H:  EMS  hardware  eaor 

Remaiks: 

Do  not  call  this  function  unless  you  know  that  EMS  memory  and  a 
correqxmding  EMM  are  installed  (see  Chapter  13  for  more  information). 

If  the  function  returns  successfully,  the  memcny  area  to  which  the  ES:DI 
register  pair  points  will  contain  two  words  f(v  each  active  handle.  The 
first  word  contains  the  handle  itself  and  the  second  wwd  ccmtains  the 
number  of  pages  allocated  to  the  handle.  The  number  of  these  entries  is 
returned  in  the  BX  registo'. 

Since  the  EMM  can  manage  a  maximum  of  2S6  handles,  the  array  will 
never  occq>y  m(xe  than  1024  bytes  (IK). 
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Interrupt  lOH,  function  OOH  EGA/VGA 

Screen:  Set  video  mode 

Sets  and  initializes  the  video  mode. 

Input:  AH  =  OOH 

AL=  EGA  video  mode 

0:  40x25-chaiacter  text,  16  colors  (EGAA^GA  -  color  monitor) 

1 :  40x25-chai*acter  text,  16  colors  (EG A/V G A  -  color  monitor) 

2:  80x25-character  text,  16  colors  (EGA/VGA  -  color  monitor) 

3:  80x25-character  text,  16  colors  (EGA/VGA  -  color  monitor) 

4:  320x200  pixel  graphics,  4  colors  (EGAA^GA  -  color  monitor) 

5:  320x200  pixel  graphics,  4  colors  (EGA/VGA  -  color  monitor) 

6:  640x200  pixel  graphics,  2  colors  (EGAA^GA  -  color  monitor) 

7:  80x25-character  text,  mono  (EGA/VGA  -  mono  monitor) 

13:  320x200  pixel  graphics,  16  colors  (EGAA^GA  -  color  mcxiitor) 

14:  640x200  pixel  graphics,  16  colors  (EGA/VGA  -  color  monitor) 

15:  640x350  pixel  graphics,  mono  (EGAA^GA  -  mono  monitor) 

16:  640x350  pixel  graphics,  4  colors  (64K  EGA-hi-res  monitor) 

640x350  pixel  graphics,  16  colors  (128K  EGAA^GA-hi-res 
monitor) 

17:  640x480  pixel  graphics,  2  colors  (VGA  only) 

18:  640x480  pixel  graphics,  16  colors  (VGA  only) 

19:  320x200  pixel  graphics,  256  colors  (VGA  only) 

Output:  No  output 

Remarks:  Modes  0  and  1,  2  and  3, 4  and  5  differ  in  the  output  of  the  color  signal 

that  is  suppressed  in  the  first  mode.  This  isn't  possible  on  an  EGAA^GA 
card  so  the  modes  are  identical.  If  bit  7  of  the  AL  regist^  is  set  when  this 
function  is  called,  the  contents  of  the  video  RAM  will  not  be  erased  when 
the  new  mode  is  enabled.  The  task  is  to  program  the  video  controller  and 
define  a  color  palette.  The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP 
and  the  segment  registers  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  OlH  EGA/VGA 

Screen:  Define  cursor  appearance 

Defines  the  starting  and  ending  lines  of  the  screen  cursor.  This  function  is 
indq)aidait  of  the  display  page  being  di^layed. 

Input:  AH-  OlH 

CH-  Starting  line  of  the  cursOT 
GL=  Ending  line  ctf  the  cursor 

Output:  No  output 

Remarks:  Since  the  possible  values  depend  on  the  size  of  the  current  video  mode’s 

character  matrix,  the  values  in  the  CH  and  CL  registers  always  refer  to  an 
eight-line  characto'  matrix.  The  values  should  thus  be  between  zoo  and 
seven.  The  EGA/VGA  BIOS  adapts  these  values  to  the  currrat  size  of  its 
own  character  matrix. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
legists  are  not  affected  by  this  fimction. 

Interrupt  lOH,  function  02H  EGA/YGA 

Screen:  Position  cursor 

Moves  the  cursor  into  position  on  the  screen. 

Input:  AH=  02H 

BH=  Video  page  numbo' 

DH=  Screen  line 
DL=  Screen  column 

Output:  No  output 

Roarks:  The  cursor  moves  only  if  the  specified  display  page  is  the  curroit  page. 

The  values  for  the  screen  line  and  column  are  based  on  the  resolution  of 
the  current  display  mode. 

Assigning  the  DH  and  DL  registers  values  for  a  non-existent  screen 
position  (e.g.,  Column  0,  line  2SS)  makes  the  cursor  disappear  from  the 
screen. 

The  number  of  the  display  page  is  based  on  how  many  display  pages  the 
card  has  available. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registers  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  OSH  EGA/VGA 

Screen:  Read  cursor  position 

Reads  the  position  (rf  the  text  cursor  on  the  screen  and  the  starting  and  ending  lines 
of  the  screen  cursw. 

Input:  AH  =  OSH 

BH=  Video  page  numbo' 

Output  DH=  Screen  line  in  which  cursOT  is  located 

DL=  Screen  column  in  which  cursor  is  located 
CH=  Starting  line  of  screen  cursor 
CL=  Ending  line  of  screen  cursor 

Ronaifcs:  The  screra  line  and  scre^  column  parameters  refer  to  the  text  coordinate 

system,  evoi  if  a  gr^^  mode  is  active. 

The  starting  and  ending  lines  of  the  cursor  are  returned  cwrectly  only  in 
the  text  modes.  They  have  no  meanings  in  grqthic  modes. 

The  contents  of  registos  BX,  SI,  DI,  BP  and  the  segmrat  registers  are  not 
affected  by  this  function. 

Interrupt  lOH,  function  OSH  EGA/VGA 

Screen:  Select  current  display  page 

Selects  the  current  display  page,  and  thereby  the  page  which  appears  <m  the  screen 
(text  mode  only). 

Input:  AH  =  OSH 

AL=  Di^lay  page  number 

Output:  No  output 

Remaiks:  The  number  of  available  display  pages  depends  on  the  amount  of  video 

RAM  installed  on  the  EGA/VGA  card. 

When  a  new  page  is  selected  the  screen  cursor  will  be  moved  to  the 
position  of  the  text  cursor  on  this  page. 

Switching  betwe^  different  pages  does  not  change  the  contorts  of  these 
pages. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  function. 


858 


Abacus 


Appendix  E:  EGA/VGA  BIOS  Functions 


Interrupt  lOH,  function  (XH  EGA/VGA 

Screen:  Scroll  text  lines  up 

ScroUs  part  ot  the  current  disiday  page  up  by  one  or  more  lines. 

Input:  AHs  06H 

ALs  Numbered  lines  to  be  scrtdled  up 
AL=0:  Clear  window 

CH=  Screen  line  of  upper  left  c(»na  of  window 
CLs  Screen  column  of  upper  left  coma  window 
DHs  Screoi  line  of  lower  right  comer  of  window 
DL=:  Screen  column  of  lower  right  c(»na  of  window 
BH=  Color  (attribute)  for  blank  line(s) 

Output:  No  output 

Remarks:  Normally  the  contents  of  the  current  display  page  are  scrolled,  but  in  the 

320x200  four-color  gis^hic  mode  this  function  only  affects  di^lay  page 

0. 

Qearing  the  screen  window  (number  of  lines  =  0)  is  the  same  as  filling  it 
with  spaces  (ASCII  code  32). 

The  contents  of  the  lines  scrolled  out  of  the  window  are  lost  and  cannot 
be  recovered. 

Use  function  0  of  this  intonipt  to  clear  the  screen. 

The  interpretation  of  the  attribute  byte  in  the  BL  register  depends  on  the 
current  video  mode.  In  text  mode  it  is  interpreted  as  any  other  attribute 
byte  in  video  RAM.  In  640x200  two-color  mode  this  byte  represents  the 
color  value  for  eight  successive  pixels.  In  320x200  four-color  mode  this 
byte  represents  the  color  value  of  four  successive  pixels.  In  all  other 
grt^hic  modes  it  represents  the  color  of  all  of  the  pixels  in  the  cleared 
soeoiarea. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  ftmetion. 

Interrupt  lOH,  function  07H  EGA/VGA 

Screen:  Scroll  text  lines  down 

Scrolls  jmt  of  the  current  display  page  down  one  ot  mOTe  lines. 

Input:  AH  =  07H 

ALs  Number  of  lines  to  be  scrolled  down 
AL^:  Gear  window 

CH=  Screen  line  of  uppa  left  coma  of  window 
CL=  Screen  column  of  upper  Id^t  coma  window 

DHs  Screoi  line  of  Iowa  right  coma  of  window 
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DLs  Screen  coliunn  of  loworig^taMner  of  window 
BHs  Colcv  (attribute)  for  blank  Iine(s) 

Output:  No  ou4)at 

Ronaiks:  Nwmally  the  contents  of  the  current  display  page  are  scrolled,  but  in 

320x200  four-color  gngrhic  mode  this  function  only  affects  diq>lay  page 

0. 

Qeaiing  the  screen  window  (number  of  lines  =  0)  is  the  same  as  filling  it 
with  spaces  (ASd  code  32). 

The  contents  of  the  lines  scrolled  out  of  the  window  are  lost  and  cannot 
be  recovered. 

To  clear  the  entire  screen,  use  functitm  0  of  this  interrupt  instead. 

The  mterpretation  of  the  attribute  byte  in  the  BL  register  depends  on  the 
current  display  mode.  In  the  text  mode  it  is  interpreted  like  any  other 
attribute  byte  in  the  video  RAM.  In  the  640x200  two-color  mode  this 
byte  represents  the  color  value  for  eight  successive  pixels.  In  the  320x200 
four-color  mode  it  rqnesents  the  color  value  of  four  successive  pixels.  In 
all  otha  graphic  modbs  it  rq)resents  the  color  of  all  of  the  pixels  in  the 
cleared  screen  area. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  OSH  EGA/VGA 

Screen:  Read  character/color 

Reads  and  returns  the  ASCII  code  and  color  (attribute)  of  the  character  at  the  curr^ 
cursor  position. 

Input  AH  =  OSH 

BH=  Video  page  numbo' 

Output  AL  =  ASCn  code  of  character 

AH=  Color  (attribute) 

Remarks;  This  function  can  also  be  called  in  the  graphic  mode,  whereby  the  bit 

pattern  of  the  character  on  the  screen  will  be  compared  with  the  bit 
patterns  of  the  characters.  If  the  character  cannot  be  identified,  the  AL 
register  will  cmitain  the  value  zoo  after  the  call. 

In  the  320x200  four-color  grr^hic  mode  this  function  only  affects  display 
pageO. 


The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registms  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  09H  EGA/VGA 

Screen:  Write  character/color 

Writes  character  with  the  specified  coIot  at  the  current  cursor  position  (in  a 
specified  display  page). 

Input:  AH  =  09H 

BHs  Video  page  number 
CX=  RqwatfKttM' 

ALs  ASCn code characto' 

BL=  Attribute 

Output:  No  ou^t 

Rmnaiks:  If  the  griy>hic  mode  is  active  and  the  specified  character  is  to  be  printed 

more  than  once  (the  value  of  the  CX  register  is  greater  than  1),  all  of  the 
charactmis  must  fit  on  the  current  screen  line. 

In  the  320x200  four-color  gi:rq>hic  mode  this  function  correctly  works 
only  on  display  page  0. 

Within  a  graphic  mode  the  attribute  h  the  BL  register  specifies  the 
foreground  color  of  the  character,  whereby  the  background  color  is  zero.  If 
bit  seven  is  set,  the  character  will  be  XORed  with  the  bitmty)  at  the 
ouQ>ut  position. 

The  controls  codes  for  bell,  carriage  return,  etc.  are  not  recognized  as 
control  codes,  and  are  displayed  as  normal  ASCII  charactos. 

This  function  can  also  be  used  to  ouq>ut  characters  in  the  graphic  mode, 
in  which  case  the  characta  patterns  are  taken  from  one  of  the  EGA 
character  tables. 

This  function  does  not  move  the  cutsot  to  the  next  screen  position. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registms  are  not  affected  by  this  function. 

Interrupt  lOH,  function  OAH  EGA/VGA 

Screen:  Write  character 

A  character  will  be  written  to  the  current  screen  position  on  the  ^recified  display 
page  and  the  color  of  the  old  character  at  this  position  will  be  retained. 

Input:  AH  =  OAH 

AL=  ASCn  code  of  the  character 
BH=  Video  page  numbm^ 

BLs  Foreground  cdor  of  charactm for  graphic  nnodes 
CX=  Rqreatfiictor 

Output:  No  ouQ>ut 
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Retnaiks:  If  the  gnq>hic  mode  is  active  and  the  ^)ecified  character  is  to  be  printed 

oKHe  than  once  (the  value  of  the  CX  register  is  greater  than  1),  all  of  the 
charactos  must  fit  on  the  current  screen  line. 

The  controls  codes  for  bell,  carriage  return,  etc.  are  not  recognized  as  such 
and  are  displayed  as  nnmal  ASCn  charactras. 

This  function  can  also  be  used  to  output  characters  in  the  graphic  mode, 
in  which  case  the  character  patterns  are  taken  from  one  of  the  EGA 
characm  tables. 

Within  a  graphic  mode  the  attribute  in  the  BL  register  specifies  the 
foreground  cdor  of  the  character,  whereby  the  background  color  is  zero.  If 
bit  seven  is  set,  the  character  will  be  XORed  with  the  bitmrq)  at  the 
output  position. 

This  fimction  does  not  move  the  cursor  to  the  next  screen  position. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  fimction. 

Interrupt  lOH,  function  OBH,  sub>function  0  EGA/VGA 

Screen:  Select  border/background  color 


Selects  the  brnda*  and  background  color  for  the  grr^hic  or  text  mode. 


Input- 

AH=  OBH 

BH=  0 

BL=  Bordo/background  color 

Output: 

No  ou4>ut 

Remarks: 

This  function  should  be  called  only  when  the  EGA/VGA  card  is  in  the 
320x200  or  640x200  graphic  mode.  Use  function  lOH  for  all  other 
modes. 

Bits  zoo  to  three  of  the  BL  register  set  the  background  and  border  coIch-. 
Setting  bit  four  will  enable  high-intensity  colors. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
regist^  are  not  affected  by  this  fimction. 

Interrupt  lOH, 
Screen:  Select 

,  function  OBH,  sub-function  1  EG  A/ VGA 

color  palette 

Selects  one  of  the  two  color  palettes  for  the  320x200  grtq;)hic  mode. 

Input:  AH=  (BH 

BH=  1 

BL=  Color  palette  number 
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No  output 

This  function  should  be  called  only  when  the  EGA/VGA  card  is  in  the 
320x200  or  640x200  graphic  mode.  Use  function  lOH  for  all  other 
modes. 

The  EGA/VGA  BIOS  emulates  the  two  CGA  color  palettes  with  the 
numbo^  0  and  1.  They  contain  the  following  coitus: 

Palette  0:  green,  red,  yellow 
Palette  1:  cyan,  magenta,  white 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  OCH  EGA/VGA 

Screen:  Write  pixel 

Sets  the  color  value  of  a  screen  pixel  in  the  graphic  mode. 

Input:  AH=  OCH 

BH=  Video  page 
DX=  Screen  line 
CX=  Screoi  column 
AL=  Color  value 

Ouq>ut:  No  output 

Remarks:  The  color  value  depends  on  the  colors  available  in  the  current  display 

mode. 

If  bit  seven  of  the  AL  register  is  set,  the  color  value  will  be  XORed  with 
the  previous  col(u  value  of  the  pixel. 

The  display  page  is  ignored  in  the  320x200  four-color  graphic  mode. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registo^  are  not  affected  by  this  fimction. 

Interrupt  lOH,  function  ODH  EGA/VGA 

Screen:  Read  pixel 

The  color  value  of  a  pixel  in  the  gr^hic  mode  is  returned. 

Input:  AH=  ODH 

BH=  Video  page 
DX=  Screen  line 
CX=  Screen  colurrm 

Output:  AL  =  Color  value 


Output: 

Remarks: 
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Ronaiks:  The  color  value  depends  on  the  coIch^  available  in  the  current  display 

mode. 

The  di^lay  page  is  ignored  in  the  320x200  four-cokH'  gr^hic  mode. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  function. 

Interrupt  lOH,  function  OEH  EGA/VGA 

Screen:  Write  character 

Writes  a  character  to  the  current  cursw  position  on  the  currait  display  page.  The 
color  of  the  dd  characto^  at  this  position  will  be  retained. 

Input:  AH=  OEH 

AL=  ASCncharacto'code 
BL=  Foreground  color  of  characto- 

Output:  No  ouq>ut 

Remarics:  This  function  does  not  treat  the  various  control  codes  like  b^ll  and 

carriage  as  normal  characters,  and  implements  them  as  the  control 
chaiact»s  they  rei»esenL 

After  displaying  a  character  with  this  function,  the  cursor  position  is 
incremented  so  that  the  next  character  will  be  printed  at  the  following 
screoi  position.  If  die  last  screen  position  has  been  reached,  the  screen 
will  be  scrolled  up  one  line  and  the  output  will  continue  in  the  Erst 
column  of  the  last  screen  line. 

If  bit  seven  of  the  BL  regista  is  set,  the  color  value  will  beXORed  with 
the  previous  color  value  of  the  pixels.  The  background  color  is  zero. 

Characters  can  be  displayed  in  the  graphic  mode  with  this  function.  Hie 
character  patt»ns  are  taken  horn  one  of  the  EGA  charactCT  tables. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  OFH  EGA/VGA 

Screen:  Returns  current  display  mode 

Reads  the  numbo’  of  the  current  display  mode,  the  number  of  characters  pa  line, 
and  the  numbo*  of  the  currrat  display  page. 

Input:  AH  =  OFH 

Output:  AL  =  Video  mode: 

0:  40x2S-character  text,  16  colors  (EGA/VGA  -  color  monitor) 

1 :  40x2S-character  text,  16  colors  (EGAl/WGA  -  color  monitor) 
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2:  80x2S-character  text,  16  cdots  (EGA/VGA  -  color  monitor) 

3:  80x2S-chaiacter  text,  16  colors  (EGaA^GA  -  colw  monitor) 

4;  320x200  pixel  gi!q>hics,  4  cdors  (EGA/VGA  -  color  moniUMr) 

5:  320x200  pixel  giiq>hics,  4  colors  (EGAA^GA  -  colrv  monitm) 

6:  640x200  pixel  gifiq>hics,  2  cdors  (EGA/vGA  -  color  monitcH) 

7:  80x2S-characier  text,  mono  (EGA/VGA  -  mono  monitor) 

13:  320x200  pixel  graphics,  16  colors  (EGAA^GA  •  color  monitor) 

14:  640x200  pixel  girqrtiics,  16  colors  (EGAA^GA  -  color  monitor) 

IS:  640x350  pixel  gr{y)hics,  mono  (EGAA^GA  -  mono  monitor) 

16:  640x350  pixel  grtq)hics,  4  colors  (64K  EGA  •  high-resolution 

monitor) 

640x350  pixel  grt^cs,  16  colors  (128K  EGAA^GA  -  high- 
resolution  monitw) 

17:  640x480  pixel  graces,  2  colors  (VGA  only) 

18:  640x480  pixel  grajMcs,  16  co1<hs  (VGA  only) 

19:  320x200  pixel  graphics,  256  colors  (VGA  oitiy) 

AH=  Number  of  characters  per  line 
BH=  Numbo' of  current  di^lay  page 

Remark:  The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 

registos  are  not  affected  by  this  function. 


Interrupt  lOH,  function  lOH,  sub-function  OOH  EG  A/ VGA 

Screen:  Set  palette  registers 

Sets  the  contents  of  a  palette  register  in  the  attribute  controller  of  the  EGAA^GA 
card. 

Input:  AH=  lOH 

AL=  OOH 
BL=  Color  value 
BH=  Register  to  be  addressed 

Ouq)ut:  No  ou^ut 

Remarks:  Since  the  register  number  is  not  checked  by  the  BIOS,  you  can  also 

program  the  other  registers  in  the  attribute  controller.  These  include  the 
mode  control  registo',  ovoscan  register  and  othos. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP,  and  the  segment 
registos  are  not  affected  by  this  function. 


Interrupt  lOH,  function  lOH,  sub-function  OlH  EGA/VGA 

Screen:  Set  screen  border  color 


Copies  resulting  value  into  the  overscan  register  of  the  EGA  attribute  controUer. 

Input:  AH  =  lOH 

AL=  OlH 
BH=  Bordercolor 
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Output:  No  output 

Remaik:  The  ctmtents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 

registers  are  not  affected  by  diis  function. 

Interrupt  lOH,  function  lOH,  sub-function  02H  EGA/VGA 

Screen:  Set  all  palette  registers 

Configures  all  16  palette  registers  and  the  overscan  registo'. 

Input*  AH=  lOH 

AL=  02H 

ES=  Segment  address  of  cokH*  table 
DX=  Offset  address  of  cokH*  table 

Output  No  output 

Remarks:  The  ES:BX  register  pair  points  to  a  17-byte  table.  The  first  16  bytes  will 

be  transferred  to  the  16  palette  registers  of  the  attribute  conuoUer  and  the 
17th  byte  will  be  copied  into  the  ovCTScan  register. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  function. 

Interrupt  lOH,  function  lOH,  sub-function  03H  EGA/VGA 

Screen:  Set  blinking  attribute 

Determines  whether  bit  7  in  the  attribute  byte  of  a  characto'  in  the  text  mode  will 
enable  character  blinking,  or  display  charactos  on  a  high-intensity  background. 

Input*  AH=  lOH 

AL=  OOH 

BL=  Blinking  attribute 

BL=0:  high-intensity  background 
BL=1:  blinking 

Output  No  ouQ>ut 

Remark:  The  contents  of  registo-s  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 

registCTS  are  not  affected  by  this  function. 

Interrupt  lOH,  function  lOH,  sub-function  07H  VGA 

Screen:  Read  out  palette  register 

Reads  the  contents  of  one  of  the  attribute  controlla's  palette  registos. 

Input  AH=  lOH 

AL=  07H 

BH=  Number  of  palette  registo* 
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OuQMit:  BL=  Contents  of  addressed  paleiteiegistar 

Remaiks:  Since  the  BIOS  doesn't  vmfy  the  numba*  of  the  palette  register  read,  this 

function  can  read  all  the  legists  of  the  attribute  ctMitrdler. 

The  contents  of  registers  BL,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registras  are  not  affected  by  this  function. 

Interrupt  lOH,  function  lOH,  sub-function  OSH  VGA 

Screen:  Read  contents  of  overscan  register 


Returns  the  contoits  of  the  ovo-scan  registo'  containing  the  screen's  border  color. 


Input 

AH=  lOH 

AL=  OSH 

Ouq>ut 

BH=  Contents  (rf  the  ovoscan  register 

Remaiks: 

The  contents  of  registers  BL,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  lOH,  sub-function  09H  VGA 

Screen:  Read  contents  of  all  palette  registers  and  the  overscan  register 

Copies  the  contoits  of  the  16  palette  registos  and  overscan  register  into  a  buffer. 

Input 

AH=  lOH 

AL=  09H 

ES=  Segmott  address  of  the  buffer 

DX=  Offset  address  of  the  buffer 

Output 

No  ou4>ut 

Remaiks; 

The  buffer  must  be  a  minimum  of  17  bytes  long  to  allow  room  for  all 
the  palette  registos  (bytes  0-lS)  plus  the  ovoscan  register  (byte  16). 

The  contents  of  registers  BL,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registos  are  not  affected  by  this  function. 


Interrupt  lOH,  function  lOH,  sub-function  lOH  VGA 

Screen:  Define  a  DAC  color  register 

Allows  the  definition  of  one  of  the  256  available  DAC  color  regist^. 

Input-  AH=  lOH 

BX=  Number  ofthe  DAC  color  register  (0-2SS) 

CH=  Gieo)  value 
CL=  Blue  value 
DH=  Red  value 
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OuQ>ut:  No  oa4>ut 

Ronaiks:  Only  bits  0  to  5  in  the  CH,  CL  and  DH  registm  are  of  importance  to 

this  function.  All  other  bits  are  igntued. 

The  contents  of  registers  BL,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registos  are  not  affected  by  this  function. 

Interrupt  lOH,  function  lOH,  sub-function  12H  VGA 

Screen:  Load  multiple  DAC  color  registers 

Allows  the  definition  of  multiple  DAC  color  regist^. 

Input:  AH=  lOH 

AL=  12H 

BX  =  Number  of  the  first  DAC  color  legisto*  (0-2SS) 

CX=  Number  of  registers  to  be  loaded 
ES=  Segment  address  of  the  buffo* 

DX=  Offset  address  of  the  buffo* 

Ou4>ut:  No  output 

Remarics:  The  assigned  buffer  must  be  able  to  hold  a  group  of  three  consecutive 

bytes  for  each  DAC  color  register.  The  first  byte  contains  the  red  value; 
the  second  byte  contains  the  green  value;  and  the  third  byte  contains  the 
blue  value.  These  first  three  bytes  corespond  to  the  first  DAC  color 
registo  being  accessed,  the  next  three  for  the  bytes  to  the  next  DAC  color 
register. 

Only  bits  0  to  5  in  the  CH,  CL  and  DH  registers  are  of  importance  to 
this  function.  All  other  bits  are  ignored. 

If  the  sum  of  BX  and  CX  is  greater  than  255,  the  first  DAC  color  register 
is  reloaded  attar  the  last  registo*  is  loaded. 

The  contents  of  registers  BL,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registos  are  unchanged  by  this  function. 

Interrupt  lOH,  function  lOH,  sub-function  13H  VGA 

Screen:  Select  color  register  or  select  a  DAC  register  group 

Manipulates  bit  7  of  the  mode  control  registers. 


Input:  AH=  lOH 

AL=  13H 

BL=  OOH  or  OlH  (see  below) 
BH=  see  below 

OuQtut:  No  ouQ>ut 
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Ronaiks:  This  sub-function  petfomis  as  two  diffoent  sub-functituis,  depoiding  on 

the  value  contain^  in  the  BL  register.  Sub-function  OOH  allows  color 
selectKHi,  while  sub-function  OlH  allows  the  selectitm  of  the  active  DAC 
register  group. 

Sub-function  OOH  copies  bit  0  in  the  BH  register  into  bit  7  of  the  mode 
control  register,  thus  providing  a  method  of  color  selectim).  If  bit  0  in  the 
BH  register  contains  a  value  of  0,  then  the  2S6  DAC  colw  registers  are 
divided  into  four  groups  of  64  registers.  Cokn*  selection  involves  bits  0-S 
in  the  corresponding  palette  registo*,  as  well  as  bits  2-3  of  the  coIot  select 
register.  These  eight  bits  act  as  the  index  for  the  DAC  color  register.  If 
bit  0  in  the  BH  registe*  ctmtains  a  1,  the  DAC  color  registers  are  divided 
into  16  groups  of  16  registers.  Then  color  selection  involves  the  lowest  4 
bits  of  the  palette  register  and  the  lowest  4  bits  of  the  color  select 
register,  acting  as  the  8-bit  index  to  the  DAC  color  table. 

Sub-function  OlH  loads  the  color  select  register,  whose  contents  are 
specified  by  the  active  group  of  DAC  color  registers.  The  coitents  of  the 
BH  registo'  are  copied  to  the  color  select  registo’. 

0 

The  contents  of  registers  BL,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registm  are  not  affected  by  this  fimction. 

Interrupt  lOH,  function  lOH,  sub-function  15H  VGA 

Screen:  Read  a  DAC  coior  register 


Returns  the  contents  of  one  of  the  256  DAC  color  registers. 


Input: 

AH=  lOH 

AL=  15H 

BX=  Number  of  the  DAC  color  registCTS 

Output: 

CH=  Green  value 

CL=  Blue  value 

DH=  Red  value 

Remarks: 

Only  bits  0  to  5  in  the  CH,  CL  and  DH  registo's  are  of  importance  to 
this  function.  All  other  bits  are  ignored. 

The  contents  of  registers  BX,  DL,  SI,  DI,  BP  and  all  segment  registas 
are  not  affected  by  this  function. 
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Interrupt  lOH,  function  lOH,  sub>function  17H  VGA 

Screen:  Load  contents  of  multiple  DAC  color  registers 

Loads  several  DAC  color  legistos  at  a  time. 

Input:  AH=  lOH 

AL=  17H 

BX=  Numbered  the  first  DAC  colm- register  to  be  loaded  (0-2SS) 

CX=  Numbo' of  registers  to  be  loaded 
ES=  Segment  address  of  buffo* 

DX=  Offset  address  {rfbuffa 

Output*  No  output 

Remarks:  Hie  contents  of  each  DAC  color  register  are  rqiresented  within  a  buffer  by 

three  consecutive  bytes.  The  red  value  is  loaded  into  the  first  of  these 
registers;  the  green  value  is  loaded  into  the  second  of  these  registers;  and 
the  blue  value  is  loaded  into  the  third  register.  The  first  group  of  three 
bytes  corresponds  to  the  first  DAC  colm*  register  addressed,  the  second 
group  to  the  next  DAC  color  register,  etc. 

Only  bits  0  to  S  in  the  CH,  CL  and  DH  regista*s  are  of  imptnlance  to 
this  function.  All  other  bits  are  igntxed. 

If  the  sum  of  BX  and  CX  is  greater  than  2SS,  the  first  DAC  color  register 
is  reloaded  after  the  last  registo*  is  loaded  (wrtgvaround  occurs). 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registos  are  not  affected  by  this  function. 


Interrupt  lOH,  function  lOH,  sub-function  18H  VGA 

Screen:  Load  DAC  mask  register 


Loads  the  specified  value  into  the  DAC  mask  regista. 


Input: 

AH=  lOH 

AL=  18H 

BL=  Value  of  DAC  mask  register 

OuQiut: 

No  ouQiut 

Remarks: 

The  contents  of  the  DAC  ma^  register  play  an  important  role  in  color 
selection.  An  AND  instruction  adds  it  to  the  index  access  to  the  DAC 
color  table. 

The  contents  of  registers  BH,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registos  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  lOH,  sub-function  19H  VGA 

Screen:  Read  out  contents  of  the  DAC  mask  register 

Reads  the  cunent  contents  of  the  DAC  mask  register. 

Input:  AH=  lOH 

AL=  19H 

Output:  BL  =  Contents  of  the  DAC  mask  register 

Ronatks:  The  contents  of  the  DAC  mask  register  play  an  imptutant  role  in  color 

selection.  An  AND  instruction  adds  it  to  the  index  access  to  the  DAC 
color  table. 

The  contents  of  registers  BH,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  10 H,  sub-function  lAH  VGA 

Screen:  Returns  method  of  color  selection  and  color  select  register 

Returns  the  method  of  color  selection,  contained  in  the  contents  of  bit  7  of  the 
mode  control  regista.  It  also  returns  the  contents  of  the  color  select  registo’  chosen 
by  the  active  group  of  DAC  color  registers. 

Input:  AH=  lOH 

AL=  lAH 

Ou^ut:  BL  =  Bit  7  of  mode  control  register 

BH  s  Contents  of  color  select  registers 

Remarics;  The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registos  are  not  affected  by  this  function. 

Interrupt  lOH,  function  lOH,  sub-function  IBH  VGA 

Screen:  Convert  DAC  color  register  into  gray  scales 

Converts  a  specified  range  within  a  DAC  color  table  into  gray  scales. 

Input:  AH=  lOH 

AL=  IBH 

BX=  Number  of  first  DAC  color  register  to  be  converted 
CX  =  Total  numbo-  of  DAC  color  registers  to  be  converted 

Output:  No  ouQrut 

Remarks:  Conversion  into  grays  results  from  changes  to  the  red,  green  and  blue 

values,  as  well  as  the  intensity  of  these  values.  The  default  factor  for  red 
is  0.3,  the  default  factor  fix'  green  is  0.S9,  and  the  default  for  blue  0.11. 
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The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registos  are  not  affected  by  diis  function. 

Interrupt  lOH,  function  IIH,  sub>function  OOH  EGA/VGA 

Screen:  Load  user-defined  character  set 

Loads  a  user-defined  character  set  frcrni  RAM  into  one  of  the  two  EGA  character 
tables. 


Input:  AH=  IIH 

AL=  OOH 

BH=  Lines  po'characta' (also  bytes  pncharacto) 

BL=  Giaracto^  table  (0  1) 

CXs  Numbo' of  characters  in  table 
DX=  ASCII  code  of  first  character  in  table 
ES  =  Segment  address  of  charact^  table  in  RAM 
BP=  Offset  address  of  chaiacto' table  in  RAM 

Ou4)ut:  No  output 

Remarks:  A  maximum  of  S 12  characters  can  be  loaded  po'ch^ract^  table. 

The  loaded  character  set  is  not  activated,  nor  are  the  CRTC  registers 
programmed  to  the  size  of  the  characters.  The  changes  will  not  be  visible 
on  the  screen  unless  the  character  definitions  are  loaded  into  the  active 
character  table. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registo^  are  not  affected  by  this  function. 


Interrupt  lOH,  function  IIH,  sub-function  OlH  EGA/VGA 

Screen:  Load  8x14  character  set 

Loads  the  entire  8xl4-pixel  character  set  from  EGA/VGA  ROM-BIOS  into  one  of 
the  two  character  set  tables. 


Input: 

AH=  IIH 

AL=  OlH 

BL=  Characta*  table  (0  or  1) 

OuQ>ut: 

No  ou^ut 

Remarks: 

The  loaded  character  set  is  not  activated,  nor  are  the  CRTC  registers 
programmed  to  the  size  of  the  characters.  The  changes  will  not  be  visible 
on  the  soreen  unless  the  character  definitions  are  loaded  into  the  active 
charact^  table. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registms  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  IIH,  sub-function  02H  EG  A/ VGA 

Screen:  Load  8x8  character  set 

Loads  the  oitire  8x8-pixel  character  set  frtxn  EGA/VGA  ROM-BIOS  into  one  of 
the  two  charactra'  set  tables. 

Input:  AH=  IIH 

AL=  02H 

BL=  Characto' table  (0  or  1) 

OuQmt:  No  output 

Remaiks:  The  loaded  characto’  set  is  not  activated,  nor  are  the  CRTC  registers 

programmed  to  the  size  of  the  characters.  The  changes  will  not  be  visible 
on  the  screen  unless  the  character  definitions  are  loaded  into  the  active 
characta  table.  The  EGA  card  displays  43  lines  (Hi  the  screen,  while  the 
VGA  card  displays  SO  lines. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  function. 

Interrupt  lOH,  function  IIH,  sub-function  03H  EGA/VGA 

Screen:  Activate  character  set 


Activates  one  (ch  two)  of  the  four  2S6-character  charact^  sets. 


Input: 

AH=  IIH 

AL=  03H 

BL=  Numbo^  of  the  characta  set  to  activate 

Ou^ut: 

No  output 

Remaiks: 

Bits  zero  and  one  of  the  BL  regista  specify  the  numba*  of  the  character 
set  to  be  accessed  when  bit  three  of  the  attribute  byte  of  the  character  is 
zoo. 

Bits  two  and  three  of  the  BL  register  specify  the  number  of  the  character 
set  to  be  accessed  when  bit  three  of  the  attribute  byte  of  the  character  is 
one. 

If  the  contents  of  bits  zero  and  one  are  identical  to  the  contents  of  bits 
two  and  three  of  the  BL  registo',  then  bit  three  of  the  character  attribute 
byte  has  no  effect  on  the  character  displayed.  Only  256  difiinent  charactos 
can  then  be  displayed  on  the  screoi. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  IIH,  sub-function  04H  VGA 

Screen:  Load  8x16  character  set 

Loads  the  entire  8xl6-pixel  character  s^  from  the  VGA  BIOS  into  one  of  the  two 
characta  set  taUes. 

Input:  AH=  IIH 

AL=  04H 

BLs:  Corresponding  characta  set  table  (0  or  1) 

Ou^ut:  No  output 

Remarks:  The  loaded  character  set  is  not  activated,  nor  are  the  CRTC  registers 

programmed  to  the  size  of  the  characters.  The  changes  will  not  be  visible 
on  the  screen  unless  the  character  definitions  are  loaded  into  the  active 
character  table.  The  VGA  card  displays  25  text  lines  on  the  screoi. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registm  are  not  affected  by  this  function. 


Interrupt  lOH,  function  IIH,  sub-function  lOH  EGA/VGA 

Screen:  Load  and  activate  user-defined  character  set 


Loads  a  user-defined  characto'  set  from  RAM  into  one  of  the  two  EGA  character 
tables  and  activates  it  by  iHogiamming  the  CRTC  registers. 


Input: 


Output* 

Remaiks: 


AH»  IIH 
AL=  lOH 

BH=  Lines  per  charact^  (also  bytes  po'charact^) 

BL=  Charact^  table  (0  or  1) 

CX=  Number  of  characters  in  table 
DX=  ASCII  code  of  first  character  in  table 
ES=  Segment  address  of  characto' table  in  RAM 
BP=  Offset  address  of  chaiacto' table  in  RAM 

No  output 

A  maximum  of  512  characters  can  be  loaded  p^  charactn  table. 

The  numbo*  of  text  lines  displayed  on  the  screen  results  from  the  height 
of  the  individual  characters.  It  is  calculated  by  dividing  the  number  of 
screen  lines  (350)  by  the  character  height. 

The  starting  and  ending  lines  of  the  screen  cursor  are  automatically 
adi^ted  to  the  height  of  the  new  characlo'  matrix. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
regist^  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  IIH,  sub-function  IIH  EGA/VGA 

Screen:  Load  and  activate  8x14  character  set 

Loads  the  entire  8xl4-pixel  character  set  from  EGA/VGA  ROM-BIOS  into  one  of 
the  two  character  set  tables,  and  activates  it  by  programming  the  CRTC  registers. 

Input:  AH=  lOH 

AL=  IIH 

BL  =  Giaracto'  table  (0  or  1) 

OuQ>ut:  No  ouq)ut 

Remarks:  The  function  sets  the  EGA  screen  to  display  25  lines  of  text,  or  sets  the 

VGA  screen  to  display  28  lines  of  text. 

The  starting  and  ending  lines  of  the  screen  cursor  are  automatically 
adr^ted  to  the  height  of  the  new  character  matrix. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registos  are  not  affected  by  this  function. 

Interrupt  lOH,  function  IIH,  sub-function  12H  EGA/VGA 

Screen:  Load  and  activate  8x8  character  set 

Loads  the  entire  8x8-pixel  character  set  from  the  ROM-BIOS  of  the  EGAA^GA 
card  into  one  of  the  two  character  set  tables,  and  activates  it  by  programming  the 
CRTC  registers. 

Input:  AH=  lOH 

AL=  12H 

BL  =  Character  table  (0  or  1) 

Output:  No  ou4>ut 

Remadcs:  The  function  sets  the  screen  to  display  43  lines  of  text  (EGA)  or  50  lines 

of  text  (VGA). 

The  starting  and  ending  lines  of  the  screen  cursor  are  automatically 
adapted  to  the  height  of  the  new  charact^  matrix. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registers  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  IIH,  sub-function  14H  VGA 

Screen:  Load  8xl(»  character  set 

Loads  a  complete  8x16  characto'  set  from  the  VGA  card  BIOS  into  one  of  the  two 
character  set  tables,  and  activates  it  through  CRTC  register  programming. 

Input:  AH=  lOH 

AL=  14H 

BL=  Qiaracto^  table  (0  (X*  1) 

OuQtut:  No  output 

Rmaiks:  When  this  function  is  called,  the  VGA  card  displays  25  lines  of  text  on 

the  screen. 

The  starting  and  ending  lines  of  the  screen  cursor  automatically  change  to 
match  the  height  of  the  new  characta  matrix. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 
regist^  are  not  affected  by  this  fimction. 

Interrupt  lOH,  function  IIH,  sub-function  30H  EGA/VGA 

Screen:  Get  information  about  the  character  generator 

Returns  various  information  about  the  current  status  of  the  character  genoator. 

Input:  AH=  IIH 

AL=  03H 

BH=  Type  of  infrxmation  desired 

BH=0:  contents  of  interrupt  vector  IFH 
BH=1:  contents  of  interrupt  vector  43H 
BH=2:  address  of  the  ROM  8x14  character  table 
BH=3:  address  of  the  ROM  8x8  charactra'  table 
BHs4:  address  of  the  second  half  oi  the  8x8  chaiacta  table 
BH=S:  address  of  the  alternative  ROM  9x14  character  table 
BH=6:  Address  of  the  altonative  ROM  8x16  character  table 
BH=7:  Address  of  the  altanadve  ROM  9x16  character  table 

OuQrut:  CX=  Height  of  current  characto' matrix 

DL  =  Number  of  columns  per  line  - 1 
ES=  Segment  address  of  the  points: 

BP=  Ofrset  address  of  the  points 

Remarks:  The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 

registers  CS,  DS  and  SS  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  12H,  sub-function  lOH  EGA/VGA 

Screen:  Determine  EGA/YGA  configuration 

Reads  the  configuration  of  the  EGA/VGA  card. 


Input:  AH=  12H 

BL=  lOH 


OuQ>ut:  BH=  Monitor  connected 

BH=0:  color  or  high-resolution  monitor 
BH=1:  monochrome  monitrar 
BL=  EGA/VGA  RAM  oqtacity 
^  BL=0: 64K 

BL=1: 128K 
BL=2: 192K 
BL=3: 256K 

Remarks:  The  contents  of  registers  DX,  SI,  DI,  BP  and  the  segment  registers  are 

not  affected  by  this  function. 


Interrupt  lOH,  function  12H,  sub-function  20H  EG  A/ VGA 

Screen:  Activate  alternate  hardcopy  routine 

Installs  an  alternative  hardcopy  routine  which  prints  as  many  lines  as  are  displayed 
on  the  screen.  The  hardcqry  routine  of  the  normal  ROM-BIOS  always  prints  25 
lines  and  is  not  suited  for  creating  a  hardcopy  of  the  EGA/VGA  modes,  which 
display  more  than  25  lines  on  the  screen. 

Input:  AH=  12H 

BL=  20H 

Output:  No  ou4>ut 

Remark:  The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 

registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  1211,  sub-function  30H  EGA/VGA 

Screen:  Specify  number  of  scan  lines 

Selects  the  numba  of  scan  lines  on  the  screen. 

Input:  AH=  12H 

BL=  30H 

AL  =  Scan  line  status 

AL=0 : 200  scan  lines  (EGA  and  VGA) 

AL=1 : 350.scan  lines  (EGA  and  VGA) 

AL=2 : 400  scan  lines  (VGA  only) 

OuQ)ut:  No  ou4>ut 


877 


Appendix  E:  EGAtVGA  BIOS  Functions 


PC  System  Programming 


Remaiks:  The  selected  number  of  scan  lines  can  only  be  displayed  when  the 

apprq>riate  video  card  and  monittM'  are  in  use.  For  example,  a  CGA 
monitor  can  only  display  200  scan  lines,  even  if  the  video  card  can 
opiate  in  a  high^  resolution. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI  and  BP  and  all  segment 
regist^s  are  not  affected  by  this  function. 

Interrupt  lOH,  function  12H,  sub-function  31H  VGA 

Screen:  Toggle  palette  register  loading 

Toggles  the  automatic  loading  of  palette  registers  in  VGA  BIOS.  The  system 
either  loads  altonate  display  modes  when  function  OOH  is  invoted,  or  loads  default 
values. 


Input:  AH=  12H 

BL=  31H 

AL=  Automatic  palette  registo' loading 
AL=0:  Yes 
AL=l:No 

Output:  No  output 

Remailcs:  The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 

registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  12H,  sub-function  32H  EGA/VGA 

Screen:  Enable/disable  CPU  access  to  video  RAM 

Enables  or  disables  direct  CPU  access  to  video  RAM  and  its  diff^nt  I/O  ports. 

Input:  AH=  12H 

BL=  32H 
AL=  Access  status 
ALsO:  Access  enabled 
ALsl:  Access  denied 

Output:  No  output 

Remaiks:  The  EGA  BIOS  doesn't  recognize  this  function,  but  you  can  still  supiness 

video  card  access  directly  using  bit  1  of  the  output  legists  (port  a^ess 
3C2H). 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registm  are  not  affected  by  this  function. 
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Interrupt  lOH,  function  12H,  sub-function  33H  VGA 

Screen:  Enabie/disable  automatic  gray  scaiing  in  DAC  color  registers 

Toggles  automatic  gray  scaling  in  VGA  BIOS.  This  is  different  from  function 
lOH,  sub-function  IBH,  which  enables  selective  gray  scaling  in  DAC  color 
registos. 


Input:  AH=  12H 

BL=  33H 

AL=  DAC  color  registo*  gray  scaling 
AL=0 :  On 
AL=1 :  Off 

Output:  No  output 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 
registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  12H,  sub-function  34H  VGA 

Screen:  Enable/disable  text  cursor  emulation 

Toggles  text  cursor  emulation  mode.  Calling  function  01 H  (for  defining  the 
starting  and  ending  lines  of  the  cursor)  doesn't  compensate  for  character  matrices  in 
different  resolutions.  This  fiitKtion  controls  that  change  when  in  VGA  mode. 

Input:  AH=  12H 

BL=  34H 

AL=  Cursor  emulation  mode 
AL=0:  On 
AL=l:Off 

OuQtut:  No  ouq>ut 

Remarks:  The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  all  segment 

registm  are  not  affected  by  this  function. 

Interrupt  lOH,  function  12H,  sub-function  36H  VGA 

Screen:  Suppress  screen  refresh 

Temporarily  suppresses  screen  refresh.  Disabling  refresh  relieves  video  RAM  of 
many  system  level  tasks,  especially  those  involving  complex  screen  graphics. 

Input:  AH=  12H 

BL=  36H 
AL=  Screen  refresh 
AL=0:On 
AL=l:Off 

Ouq)ut:  No  output 
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Remaiks:  The  contents  of  registers  BX,  CX,  DX,  SI.  DI,  BP  and  all  segment 

regist^  are  not  affected  by  this  function. 


Interrupt  lOH,  function  13H  EGA/YGA 

Screen:  Display  a  string 

Displays  a  string  at  a  specified  position  on  the  screen,  in  a  specific  display  page. 
The  charact^  are  taken  from  a  whose  address  is  passed  to  the  function. 


Input:  AH=  13H 

AL  =  Output  mode  (0-3) 

AL=0:  Attribute  in  BL.  reserwc  cursor  position 
AL=1:  Attribute  in  BL.  update  cursor  position 
AL=2:  Attributes  in  buffer,  reserve  cursor  position 
AL=3:  Attributes  in  buffo,  update  cursor  position 
BL  =  Attribute  byte  of  characters  (modes  0  and  1  only) 

CX=  Number  of  characters  to  be  printed 
DH  =  Screen  line 
DL  =  Screen  column 
BH=  Video  page 

ES=  Segment  address  of  the  buffo 
BP=  Offset  address  of  the  buffer 

Output:  No  output 

Remarks:  In  modes  1  and  3  the  cursor  position  is  placed  after  the  last  character  of 

the  string  so  that  BIOS  output  will  continue  at  the  character  after  the 
string.  This  does  not  happen  in  modes  0  and  2. 

In  modes  0  and  1  the  buffer  contains  only  the  ASCII  codes  of  the 
characters  to  be  printed.  The  color  of  all  of  the  characters  in  th^  string  is 
specified  by  the  BL  register.  In  modes  2  and  3,  each  character  in  the  buffer 
is  followed  by  the  corresponding  attribute  byte,  so  that  each  charact^  has 
its  own  attribute.  The  BL  registo*  does  not  have  to  be  loaded  in  these 
modes.  Although  the  string  must  be  twice  as  long  as  the  number  of 
characters  to  be  printed  in  these  modes,  the  CX  register  contains  just  the 
number  of  ASQI  characters  to  be  printed,  not  the  string  buffer’s  length. 

Control  codes  such  as  bell  and  carriage  return  are  interpreted  as  control 
codes  and  not  as  normal  ASCII  codes.  An  error  occurs  when  carriage 
return  and  linefeed  are  printed  on  a  display  page  other  than  zero,  however. 
These  characters  may  be  printed  on  display  page  0.  regardless  of  the 
display  page  specified  in  BH. 

When  the  last  screen  position  is  reached  the  screen  will  move  up  one  line 
and  the  output  will  continue  with  the  first  column  of  the  last  screen  line. 

When  printing  in  the  graphic  mode  the  contents  of  the  BL  register 
determine  the  foreground  color  of  the  character  (the  background  is  zero).  If 
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bit  seven  of  the  BL  register  is  set,  the  color  value  will  be  XORed  with 
the  old  color  value. 

This  function  can  also  be  used  to  print  characters  in  the  grig>hic  mode,  in 
which  case  theeharacter  pattons  will  be  taken  from  one  d  the  EGA/VGA 
character  tables. 

The  contents  of  registers  BX,  CX,  DX,  SI,  DI,  BP  and  the  segment 
registers  are  not  affected  by  this  function. 

Interrupt  lOH,  function  lAH  VGA 

Screen:  Determine  video  card  type 

Determines  the  existence  of  the  active  video  card. 

Input:  AH=  13H 

AL=  0 

Output:  AL=  lAH 

BL=  Device  code  for  active  video  card 
BH=  Device  code  for  inactive  video  card 

Remadcs:  If  the  value  lAH  is  not  loaded  into  the  AL  register,  then  the  video  card  in 

operation  is  not  a  VGA  card  (the  lAH  indicates  a  VGA  BIOS).  The 
function  can  return  the  following  device  codes: 

FFH  =  Unkiwwn  video  card 

OOH  =  No  video  card 

OlH  =  MDA  with  moiKKhrome  display 

02H  =  CGA  with  CGA  monitor 

04H  =  EGA  with  EGA  or  multisync  monitor 

OSH  =  EGA  -  monochrome  display 

07H  =  VGA  -  analog  monochrome  display 

OSH  =  VGA  -  analog  color  display  (VGA,  multisync) 

The  contents  of  regist^s  CX,  DX,  SI,  DI,  BP  and  all  segment  registos 
are  not  affected  by  this  function. 
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Interrupt  function  OOH  Mouse 

Reset  mouse  driver 

Resets  (initializes)  the  mouse  driwct. 

Input:  AX=  OOOOH 

Output:  AX  =  Mouse  installation  status 

AX=FFFFH:  Mouse  driver  installed 
AX=0000H:  Error,  no  mouse  driver  installed 
BX=  Number  of  mouse  buttons 

Remarks:  The  reset  process  executes  the  following  tasks: 

Moves  the  mouse  pointer  to  the  center  of  the  screen  and  clears  the  pointer 
from  the  screen.  When  enabled,  the  default  points  appears  as  an  inverse 
video  square.  The  representation  is  always  in  display  page  0,  independent 
of  the  current  dii^lay  mode.  The  entire  screen  area  becomes  the  total  range 
of  mouse  movement. 

Installs  the  event  handler  is  installed  by  a  program  (default  is  disabled). 

Installs  lightpen  emulation  (default  is  disabled). 

Specifies  mouse  pointer's  speed.  Default  relative  speed  is  8  mickeys  p^  8 
horizontal  pixels  and  16  mickeys  per  16  vertical  pixels. 

Specifies  maximum  mouse  speed  (default  is  64  mickeys  per  second). 
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Interrupt  33H,  function  OlH  Mouse 

Display  mouse  pointer 

Displays  the  mouse  pointer  on  the  screra.  This  pointer  follows  any  movement  the 
user  makes  with  the  mouse  device. 

AX=  OOOIH 

No  ou^ut 

This  function  increments  an  internal  counto:  which  determines  whether 
the  mouse  pointer  should  be  displayed  on  the  screen.  When  the  mouse 
drivo’  is  initialized  using  function  OOH,  this  pointer  contains  the  value  -1 
(i.e.,  the  mouse  pointer  does  not  appear).  If  this  counter  contains  the 
value  0  after  calling  function  OlH,  the  mouse  pointer  appears  on  the 
soeen. 

The  mouse  drivo*  follows  the  mouse  movement  even  when  the  mouse 
pointer  is  not  displayed  on  the  screen.  After  calling  this  function,  the 
mouse  pointer  may  not  appear  at  the  same  location  as  it  was  when  the 
points  was  previously  removed  by  calling  function  OOH  or  function  02H. 

Interrupt  33H,  function  02H  Mouse 

Remove  mouse  pointer 

Removes  the  mouse  pointa*  from  the  screen. 

Input  AX=  0002H 

OuQ)ut:  No  ou^ut 

Remarks:  This  function  decrements  an  internal  counter  which  determines  whether 

the  mouse  pointer  should  appear  on  the  screen.  If  the  counter  contains  the 
value  0,  the  mouse  pointer  is  displayed  on  the  screen,  while  the  value  -1 
removes  the  mouse  pointer  from  the  screra. 

The  mouse  driver  follows  the  mouse  movement  even  when  the  mouse 
pointo'  is  not  displayed  on  the  screen. 

After  calling  this  function,  the  mouse  pointer  may  not  ^>pear  at  the  same 
location  as  it  was  when  the  pointer  was  previously  removed  by  calling 
function  OOH  or  function  02H. 


Input 

OuQ>ut: 

Remarks: 
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Interrupt  33H,  function  03H  Mouse 

Get  pointer  position/button  status 

Returns  the  current  position  of  the  mouse  pointer  and  the  current  status  of  the 
mouse  buttons. 

Input  AX=  0003H 

Output  BX=  Mouse  button  status 

Bit  0=1:  Left  mouse  button  activated 
Bit  1=1:  Right  mouse  button  activated 
Bit  2=1:  Center  mouse  button  activated 
Bits  3-15:  Unused 

CX=  X  coordinate  (hoizontal  mouse  position) 

DX  =  Y  coordinate  (votical  mouse  position) 

Remarks:  The  coordinates  returned  in  the  CX  and  DX  registers  refer  to  the  pixel 

positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen. 

If  the  mouse  is  equipped  with  only  two  moose  buttons,  the  information 
about  the  central  mouse  button  does  not  have  significance. 

Interrupt  33H,  function  04H  Mouse 

Move  mouse  pointer 

Moves  the  active  mouse  pointer  to  a  c^tain  position  on  the  screen. 

Input  AX=  0004H 

CX  =  X  coordinate  (hoizontal  mouse  position) 

DX  =  Y  coordinate  (votical  mouse  position) 

Output:  No  ouq)ut 

Remarks:  The  coordinates  returned  in  the  CX  and  DX  registers  refer  to  the  pixel 

positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen. 

If  the  position  indicated  is  outside  the  range  of  movement  specified  by 
functions  07H  and  OSH,  the  function  adjusts  coordinates  so  that  the 
mouse  pointer  remains  within  this  range  of  movement. 

The  mouse  pointer  moves  to  the  new  position,  even  if  the  mouse  is  not 
currently  visible.  Once  re-enabled,  the  mouse  pointer  appears  at  this  new 
position. 
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Interrupt  33H,  function  OSH  Mouse 

Determine  number  of  times  mouse  button  was  activated 

Informs  the  calling  program  of  how  often  a  mouse  button  has  been  pressed  since 
the  last  call  of  function  OSH.  Function  OSH  also  informs  the  calling  program  of 
the  pointer's  location  on  the  screen  when  the  button  was  last  activated. 

Input  AX=  OOOSH 

BX=  Mouse  button  activated 
BX=0:  Left  mouse  button 
BX=1:  Right  mouse  button 
BX=2:  Center  mouse  button 

Output;  BX=  Status  of  all  mouse  buttons: 

Bit  0=1:  Left  mouse  button  activated 
Bit  1=1:  Right  mouse  button  activated 
Bit  2=1:  Cmto^  mouse  button  activated 
Bits  3-lS:  Unused 

BX  =  Mouse  buttons  activated  since  last  function  call 
CX  =  Hcnizontal  mouse  position  during  the  last  activation 
DX  =  Vmical  mouse  position  during  the  last  activation 

Remadcs:  The  coordinates  returned  in  the  CX  and  DX  registers  refer  to  the  pixel 

positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen.  The  activation  counter  for  the 
iripuse  button  addressed  is  reset  to  0  when  this  function  is  called. 

Interrupt  33H,  function  06H  Mouse 

Determine  number  of  times  mouse  button  was  released 

Informs  the  calling  program  of  how  often  a  mouse  button  has  been  released  since 
the  last  call  of  function  06H.  Function  06H  also  informs  the  calling  program  of 
the  pointa‘'s  location  on  the  screen  when  the  button  was  last  activated. 

Input  AX=  0006H 

BX=  mouse  button  addressed 
BX=0:  Left  mouse  button 
BX=1:  Right  mouse  button 
BX=2:  Center  mouse  butum 

Output:  BX=  Status  of  all  mouse  buttons 

Bit  0=1:  Left  mouse  button  activated 
Bit  1=1:  Right  mouse  button  activated 
Bit  2=1:  Center  mouse  button  activated 
Bits  3-15;  Unused 

BX  =  Mouse  buttons  activated  since  last  function  call 
CX  =  Hcnizontal  mouse  position  during  the  last  activation 
DX  =  V^cal  mouse  position  during  the  last  activation 
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Remarks:  The  coordinates  returned  in  the  CX  and  DX  registers  refer  to  the  pixel 

positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen. 

The  activation  counter  for  the  mouse  button  addressed  is  reset  to  0  when 
this  function  is  called. 

Interrupt  33H,  function  07H  Mouse 

Set  horizontal  range  of  movement 

Defines  the  horizontal  range  of  movement  for  the  mouse  pointer.  Once  set,  the 
user  cannot  move  the  mouse  points  out  of  this  range. 

Input  AX=  0007H 

CX  =  Minimal  horizontal  pointer  position 
DX=  Maximum  horizontal  pointer  position 

Ouq)ut:  No  ouQ)ut 

Remaiks:  The  coordinates  passed  in  the  CX  and  DX  registers  refer  to  the  pixel 

positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen. 

If  the  mouse  points  is  outside  of  this  range  when  function  07H  is  caUed, 
the  mouse  driver  automatically  moves  the  mouse  pointer  within  the 
limits  of  the  range  of  movement.  If  the  value  in  the  DX  register  is  less 
than  the  value  in  the  CX  legists,  the  two  paramet^a  are  exchanged. 

Interrupt  33H,  function  OSH  Mouse 

Set  vertical  range  of  movement 

Defines  the  vertical  range  of  movement  for  the  mouse  pointer.  Once  set,  the  user 
cannot  move  the  mouse  pointer  out  of  this  range. 

Input  AX=  0008H 

CX  =  Minimum  vertical  pointer  posititm 
DX=  Maximum  vertical  pointer  position 

Output:  No  ouq)ut 

Remaiks:  The  coordinates  passed  in  the  CX  and  DX  registers  refer  to  the  pixel 

positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen. 

If  the  mouse  points  is  outside  of  this  range  wh^  function  07H  is  called, 
the  mouse  driver  automatically  moves  the  mouse  pointer  within  the 
limits  of  the  range  of  movement. 
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If  the  value  in  the  DX  register  is  less  than  the  value  in  the  CX  regist^, 
the  two  parametm  are  exchanged 

Interrupt  33H,  function  09H  Mouse 

Set  mouse  pointer  (graphic  mode) 

Defines  the  appearance  of  the  mouse  pointer  in  graphic  mode,  as  well  as  the 
bitfield  which  compensates  for  the  pixels  around  the  mouse  points. 

Input  AX=  0009H 

BX  =  Pointer  width  starting  at  left  bordo'  of  bitfield 
CX  =  Pointer  height  starting  at  top  border  of  bitfield 
ES=  Segment  address  of  bitfield 
DXs  Offset  address  of  bitfield 

Output:  No  output 

Remarks:  The  bitfield  consists  of  64  bytes,  of  which  the  first  32  are  an  AND 

comparison,  and  the  remaining  32  are  an  OR  combination.  Both  sets  of 
bytes  are  based  upon  the  current  pixel  pattern. 

Interrupt  33H,  function  OAH  Mouse 

Set  mouse  pointer  (text  mode) 

Defines  the  bitmask  which  specifies  the  appearance  of  the  mouse  pointer  in  text 
mode. 

Input  AX=  OOOAH 

BX=  Pointer  type 

BX=0:  Software  points 
BX=1:  Hardware  pointer 

CX  =  AND  mask  (software  pointer)  or  starting  line  (hardware  pointo') 

DX  =  XOR  mask  (software  points)  or  ending  line  (hardware  points) 

Output:  No  ouQiut 

Remarks:  If  the  software  pointer  is  selected,  the  code  of  the  character  beneath  the 

mouse  pointer  and  its  attribute  byte  are  combined  logically  with  the  mask 
in  the  CX  register  through  a  binary  AND,  and  then  with  the  value  in  the 
DX  register  through  an  exclusive  OR  (XOR).  The  attribute  byte  is 
combined  with  the  most  significant  byte  (C^  and  DH).  The  character  code 
is  combined  with  the  least  significant  byte  (CL  and  DL). 

The  hardware  pointer  is  the  same  shape  as  the  normal  text  mode  cursor. 
Monochrome  mode  values  for  the  starting  and  ending  lines  range  from  0 
to  13.  Color  mode  values  for  the  starting  and  ending  lines  range  from  0  to 
7. 
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Interrupt  33H,  function  OBH  Mouse 

Determine  movement  values 

Determines  the  distance  between  the  current  mouse  position  and  the  mouse 
position  during  the  last  caU  of  function  OBH. 

Input  AX=  OOOBH 

Output:  CX=  Horizontal  distance  from  last  point  in  mickeys 

DX  =  Votical  distance  from  last  point  in  micteys 

Remarks:  These  values  must  be  interpreted  as  signed  numbers.  Positive  values 

indicate  movement  toward  the  bottom  right  bmdet  of  the  screen,  while 
negative  values  indicate  movement  toward  the  top  or  left  IxH'd^  of  the 
screen. 

These  values  are  given  in  mickeys.(l  mickey= 1/200  inch)  rather  than  in 
pixels. 

Interrupt  33H,  function  OCH  Mouse 

Set  event  handler 

Sets  the  address  of  an  event  handler  called  by  the  mouse  driver  when  a  particular  ) 
mouse  event  occurs. 

Input  AX=  OOOCH 

CX  7  Events  which  trigger  the  call  of  the  event  handle  (event  mask) 

Bit  0:  Mouse  movement 
Bit  1:  Left  mouse  button  activated 
Bit  2:  Left  mouse  button  released 
Bit  3:  Right  mouse  button  activated 
Bit  4:  Right  mouse  button  released 
Bit  5:  Center  mouse  button  activated 
Bit  6:  Center  mouse  button  released 
Bits  7-15:  Unused 
ES=  Segment  address  of  handlo' 

DX=  Offset  address  of  handla 

Output:  No  ou^ut 

Remarks:  The  event  handler  is  called  by  the  mouse  driver  through  a  FAR  call 

assembler  instruction,  and  thoefore  must  be  terminated  with  a  FAR  RET 
instruction.  None  of  the  various  processor  registos  may  be  returned  to  the 
caller  with  a  changed  content. 

The  mouse  driver  passes  the  following  information  to  the  event  handler 
through  the  processor  registers  during  the  call: 

AX  =  event  mask.  The  bits  correspond  to  the  various  events  as  indicated 
in  the  CX  register  during  the  installation  of  the  event  handler.  In 
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addition,  other  bits  can  be  set,  since  the  value  reflects  the  current 
status  of  the  mouse  drivo',  and  is  not  limited  to  the  selected  events. 

BXs  mouse  button  status: 

Bit  0  =  Left  mouse  button  activated 
Bit  1  =  Right  mouse  button  activated 
Bit  2  =  Center  mouse  button  activated 

CX  =  horizontal  mouse  position. 

DX=  votical  mouse  position. 

SI  =  length  of  last  horizontal  mouse  movement 

DI  =  length  of  the  last  vertical  mouse  movement 

DS  =  data  segment  of  the  mouse  drivo^. 

The  coordinates  returned  in  the  CX  and  DX  registers  refer  to  the  pixel 
positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  scre^. 

The  values  in  the  SI  and  DI  registers  refer  to  mickeys  (one  mickey  = 
1/200  inch). 

These  mickey  values  must  be  interpreted  as  signed  numbers.  Positive 
values  indicate  movement  toward  the  bottom  or  right  bord»  of  the  screen, 
while  negative  values  indicate  movement  toward  the  top  or  left  border  of 
the  screen. 

Interrupt  33H,  function  ODH  Mouse 

Enable  lightpen  emulation 

Enables  emulation  of  the  lightpen,  and  simulates  a  lighqren  which  if  none  is 
present 


Input  AX=  OOODH 

Output:  No  ouqrut 

Remadcs:  Lightpen  emulation  only  makes  sense  when  used  with  an  application 

which  supports  the  ligh^n,  or  makes  lightpen  reading  routines  available 
(e.g.,  the  PEN  command  in  PC-BASIC). 

The  lightpen  and  mouse  are  closely  related  in  programming:  The  position 
of  the  mouse  pointer  is  directly  related  to  the  lightpen's  position  on  the 
screen,  and  pressing  the  left  and  right  mouse  button  has  the  same  result  as 
pressing  the  button  on  the  lightpen. 
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Interrupt  SSH,  function  OEH  Mouse 

Disable  lightpen  emulation 

Disables  the  lightpen  emulation  enabled  by  a  previous  call  to  function  ODH. 

Input  AX=:  OOOEH 

Output:  No  output 

Remarks:  Lightpen  emulation  only  makes  sense  when  used  with  an  application 

which  suppcHts  the  lightpen,  or  makes  lightpen  reading  routines  available 
(e.g.,  the  PEN  command  in  PC-BASIC). 

The  lightpen  and  mouse  are  closely  related  in  progranuning:  The  position 
of  the  mouse  pointer  is  directly  related  to  the  lightpen's  position  on  the 
screen,  and  pressing  the  left  and  right  mouse  button  has  the  same  result  as 
pressing  the  button  on  the  lighq)en. 

Interrupt  33H,  function  OFH  Mouse 

Set  pointer  speed 

Defines  the  relationship  between  mickeys  and  screen  pixels.  This  specifies  the 
sensitivity  of  the  mouse  and  the  speed  at  which  the  mouse  pointer  moves  across 
the  screen. 

AX=:  OOOFH 

CX=  Number  of  horizontal  mickeys 
DX=  Number  of  vertical  mickeys 

No  output 

Values  in  the  CX  and  DX  registers  can  range  from  1  to  32767. 

The  default  setting  is  8  horizontal  mickeys  and  16  vmical  mickeys.  This 
causes  the  mouse  pointer  to  move  twice  as  fast  horizontally  as  it  moves 
vertically. 

Calling  function  OOH  (Reset  mouse  driver)  changes  any  previously  set 
values  to  the  default  values. 


Input 

Output: 

Remarks: 
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Interrupt  33H,  function  lOH  Mouse 

Exclusion  area 

Designates  any  area  of  the  screen  as  an  exclusion  area.  The  mouse  pointer 
disaiq)ears  if  moved  into  the  exclusion  area. 

Input  AX=  OOlOH 

CXs  X-coodinate,  upper  left  comer  of  exclusion  area 
DX=  Y-coordinate,  upper  left  coma- (^exclusion  area 
SI  =  X-coodinate,  lower  right  como'  of  exclusion  area 
DI=  Y-co(xdinate,  lower  right  coma  of  exclusion  area 

Output:  No  ou^ut 

Remarks:  The  coordinates  passed  in  the  CX,  DX,  DI  and  SI  registos  refer  to  the 

pixel  positions  in  the  virtual  mouse  di^lay  screen  ratha  than  physical 
positions  on  the  actual  display  screen. 

Calling  function  OOH  (Reset  mouse  driver)  or  function  OlH  (Display 
mouse  pointa)  deletes  the  exclusion  area  coordinates. 

Interrupt  33H,  function  13H  Mouse 

Set  maximum  for  mouse  speed  doubling 

Sets  the  maximum  limit  for  doubling  mouse  speed.  If  the  speed  of  the  mouse 
movement  exceeds  a  certain  limit,  the  mouse  driver  doubles  the  mouse  pointer 
speed  by  doubling  the  movement's  relationship  between  points  and  mickeys. 

Input  AX=  0013H 

DX=  Limit  in  mickeys  per  second 

Output:  NoouQtut 

Remarks:  1  mickeys 1/200  inches. 

To  prevent  doubling  of  tbe  mouse  speed,  the  limit  can  be  set  higher. 

Speeds  in  excess  of  5,000  mickeys  per  second  cannot  be  achieved  by 
practical  means. 
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Interrupt  33H,  function  14H  Mouse 

Exchange  event  handlers 

Installs  a  new  event  handler  for  certain  mouse  events,  but  also  retains  the  address 
of  the  old  event  handle. 


Input 


Output: 


Remaiks: 


AX=  0014H 

CX=  Events  which  should  trigger  event  handler  call 

Bit  0:  Mouse  movement 

Bit  1:  Left  mouse  button  activated 

Bit  2:  Left  mouse  button  released 

Bit  3:  Right  mouse  button  activated 

Bit  4:  Right  mouse  button  released 

Bit  S:  Center  mouse  button  activated 

Bit  6:  Center  mouse  button  released 

Bit  7-15:  Unused 

ES=  Segment  address  of  new  event  handler 
DX=  Offset  address  of  new  event  handler 

CX  =  Event  mask  of  the  previously  installed  event  handler 
ES  =  Segment  address  of  previously  installed  event  handler 
DX=  Offset  address  of  previously  installed  event  handler 

The  event  handler  is  called  by  the  mouse  driver  through  a  FAR  call 
assembler  instruction,  and  therefore  must  be  terminated  with  a  FAR  RET 
instruction.  None  of  the  various  processor  registers  may  be  returned  to  the 
caller  with  a  changed  content. 

The  mouse  driver  passes  the  following  information  to  the  event  handler 
through  the  processor  registers  during  the  call: 

AX  =  event  mask.  The  bits  correspond  to  the  various  events  as  indicated 
in  the  CX  register  during  the  installation  of  the  event  handler.  In 
addition,  other  bits  can  be  set,  since  the  value  reflects  the  current 
status  of  the  mouse  driver,  and  is  not  limited  to  the  selected  events. 

BX=  mouse  button  status: 

Bit  0  =  Left  mouse  button  activated 
Bit  1  =  Right  mouse  button  activated 
Bit  2  =  Center  mouse  button  activated 
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CX=  horizontal  mouse  position. 

DX=  vertical  mouse  position. 

SI  =  length  of  last  horizontal  mouse  movement 
D1  =  length  of  the  last  vertical  mouse  movement 
DS  s  data  segmm  of  the  mouse  drivo'. 

The  coordinates  returned  in  the  CX  and  DX  registers  refer  to  the  pixel 
positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen. 

The  values  in  the  SI  and  D1  registers  refer  to  mickeys  (one  mickey  = 
1/200  inch). 

These  mickey  values  must  be  interpreted  as  signed  numbers.  Positive 
values  indicate  movement  toward  the  bottom  or  right  border  of  the  screen, 
while  negative  values  indicate  movement  toward  the  top  or  left  border  of 
the  screen. 

Interrupt  33H,  function  15H  Mouse 

Determine  mouse  status  buffer  size 

Returns  the  size  of  the  mouse  status  buffer,  in  which  a  program  can  store  the 
complete  status  of  the  mouse  driver. 

Input  AX=  0015H 

Output:  BX  =  Mouse  status  buffer  size  in  bytes 

Remarks:  Function  16H  (Store  mouse  status)  stores  the  mouse  status  in  the  buffer. 

Interrupt  33H,  function  ItiH  Mouse 

Store  mouse  status 

Stores  mouse  status  information  in  a  buffer. 

Input  AX=  0016H 

ES  =  Segment  address  of  mouse  status  buffo' 

DX  =  Offset  address  of  mouse  status  buffer 

Output:  No  output 

Remarks:  The  caller  is  responsible  for  creating  a  buffer  large  enough  to  contain  all 

the  status  information.  Before  calling  this  function,  call  function  ISH 
(Determine  mouse  status  buffer  size)  to  determine  the  size  of  the  mouse 
status  buffer. 
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This  function  works  well  when  called  bef(»e  executing  a  {wogram  using 
the  EXEC  function.  This  allows  the  mouse  status  to  be  saved  in 
memory,  then  restored  from  within  the  called  program. 

Interrupt  33H,  function  17H  Mouse 

Restore  mouse  status 

Reads  all  mouse  parameters  from  a  buffer  where  they  had  been  stored  by  fimction 
16H. 

Input  AX=  0017H 

ES=  Segment  address  of  mouse  status  buffio’ 

DX=  Offset  address  of  mouse  status  buffer 

OuQ)ut:  No  output 

Interrupt  33H,  function  18H  Mouse 

Install  alternate  event  handler 

This  function  permits  a  program  to  install  a  limited  range  event  handler.  This 
handler  can  be  called  by  the  mouse  driver  when  certain  mouse  events  occur  in 
ccMijunction  with  the  keyboard. 

Input  AX=  0018H 

CX  =  Events  which  should  triggo'  the  call  of  the  event  handin’ 

Bit  0:  Mouse  movement 

Bit  1:  Left  mouse  button  activated 

Bit  2;  Left  mouse  button  released 

Bit  3:  Right  mouse  button  activated 

Bit  4;  Right  mouse  button  released 

Bit  S:  Shift  key  pressed  during  mouse  button  event 

Bit  6:  Ctrl  key  {sessed  during  mouse  button  event 

Bit  7:  Alt  key  pressed  during  mouse  button  event 

Bits  8-15:  Unused 

ES=  Segment  address  of  event  handler 
DX=  Offset  address  of  evmt  handler 

Output:  AX=  Installation  status 

AX=(X)18H:  Event  handln  installed  ^ 

AX=FFFFH:  Event  handler  could  not  be  installed 

Remarics:  At  least  one  of  bits  S  to  7  must  be  set  in  the  event  mask  of  the  CX 

register  to  ensure  that  the  event  reacts  to  at  least  one  of  the  control  keys. 
If  the  programmer  prefers  not  to  read  the  Shift,  Ctrl  or  Alt  keys  along 
with  mouse  buttons,  use  functions  OCH  w  14H  instead. 

An  error  can  occur  if  three  alternate  event  handlers  were  previously 
installed,  w  if  an  event  handler  with  the  same  evoit  mask  already  exists. 
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Remaiks: 


The  event  handler  is  called  by  the  mouse  driver  through  a  FAR  call 
assembler  instruction,  and  therefore  must  be  terminated  with  a  FAR  RET 
instruction.  None  of  the  various  processor  legists  may  be  returned  to  the 
caller  with  a  changed  content 

The  mouse  driver  passes  the  following  infcmnation  to  the  event  handler 
through  the  processw  legists  during  the  call; 

AX  =  event  mask.  The  bits  ccnrespond  to  the  various  events  as  indicated 
in  the  CX  register  during  the  installation  of  the  event  handler.  In 
addition,  otha  bits  can  be  set  since  the  value  reflects  the  current 
status  of  the  mouse  driva*,  and  is  not  limited  to  the  selected  events. 

BX=  mouse  button  status: 

Bit  0  =  Left  mouse  button  activated 
Bit  1  =  Right  mouse  button  activated 
Bit  2  =  Center  mouse  button  activated 

CX  =  horizontal  mouse  position. 

DX  =  vertical  mouse  position. 

SI  =  length  of  last  horizontal  mouse  movement 

DI  =  length  of  the  last  vertical  mouse  movement 

DS=  data  segment  of  the  mouse  driver. 

The  coordinates  returned  in  the  CX  and  DX  registers  refer  to  the  pixel 
positions  in  the  virtual  mouse  display  screen  rather  than  physical 
positions  on  the  actual  display  screen. 

The  values  in  the  SI  and  DI  registras  refer  to  mickeys  (one  mickey  = 
1/200  inch). 

These  mickey  values  must  be  interpreted  as  signed  numbers.  Positive 
values  indicate  movement  toward  the  bottom  or  right  btHtlo'  of  the  screen, 
while  negative  values  indicate  movement  toward  the  top  or  left  border  of 
the  screen. 
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Interrupt  33H,  function  1911  Mouse 

Determine  address  of  alternate  event  handler 


Returns  the  address  of  an  alternate  event  handler  to  the  caller. 


Input 

AX=  0019H 

CX=  Event  handle  event  mask 

Ouq>ut: 

CX=  OOOOHiEiror 

ES  =  Segment  address  of  event  handlo* 

DX=  Offset  address  of  event  handlo^ 

Remaiks; 

See  the  description  of  function  18H  above  for  additional  information 
about  the  meanings  of  each  bit  in  the  event  mask. 

The  function  call  fails  if  no  alternate  event  handler  with  the  indicated 
event  mask  was  previously  installed. 

Interrupt  33H,  function  lAH 

Set  mouse  sensitivity 

Mouse 

Defines  the  relationship  between  physical  mouse  movement  and  mouse  pointer 
movement  Also  defines  the  maximum  for  doubling  mouse  speed. 

Input  AX=  001  AH 

BX=  Number  of  horizontal  mickeys 

CX=  Number  of  vertical  mickeys 

DX  =  Maximum  limit  for  doubling  the  mouse  speed 

Output:  No  output 

Remarks:  Values  in  the  CX  and  DX  registers  can  range  from  1  to  32767. 

The  default  setting  is  8  horizontal  mickeys  and  16  vertical  mickeys.  This 
causes  the  mouse  pointer  to  move  twice  as  fast  horizontally  as  it  moves 
vertically. 

To  prevent  doubling  of  the  mouse  speed,  the  limit  can  be  set  higher. 

Speeds  in  excess  of  5,000  mickeys  per  second  cannot  be  achieved  by 
practical  means. 

Calling  function  OOH  (Reset  mouse  driver)  changes  any  previously  set 
values  to  the  default  values. 
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Interrupt  33H,  function  IBH  Mouse 

Determine  mouse  sensitivity 

Returns  the  parameters  {ffeviously  set  by  calling  function  lAH  or  functions  OFH 
and  13H. 

Input  AX=  OOIBH 

Output;  BXs  Number  of  horizontal  mickeys 

CX=  Number  (tf  votical  mickeys 
DX=  Maximum  limit  few  doubling  the  mouse  speed 

Interrupt  33H,  function  ICH  Mouse 

Set  mouse  hardware  interrupt  rate 


Determines  the  frequency  at  which  the  mouse  hardware  reads  the  current  mouse 
position  and  mouse  button  status. 


Input 

AX=  OOlCH 

BX=  InteiTuptrate 

Bit  0:  No  interrupts 

Bit  1: 30  intorupts  per  second 

Bit  2:  SO  interrupts  per  second 

Bit  3: 100  interrupts  per  second 

Bit  4: 200  interrupts  per  second 

Bits  5-15:  Unused 

Ouq)ut: 

No  ouq)ut 

Remarks: 

This  functiem  is  only  available  for  the  Inport  mouse. 

If  more  than  one  bit  is  set  in  the  BX  register,  only  the  least  significant 
bit  which  is  set  counts. 

The  mouse's  resolution  increases  with  the  number  of  interrupts.  The 
increased  number  of  mouse  interrupts  decreases  the  speed  of  the 
foreground  program. 

Interrupt  33H,  function  IDH 

Set  display  page 

Mouse 

Specifies  the  display  page  on  which  the  mouse  pointer  tqrpears. 

Input 

AX=  OOIDH 

BX=  Number  of  the  display  page 

Ouq)ut: 

No  output 

Remarks: 

Default  value  is  display  page  0. 
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Calling  this  function  only  makes  sense  if  the  application  program  Wiprks 
widi  several  display  pages,  as  available  on  CGA,  EGA  and  VGA  cards. 

Interrupt  33H,  function  lEH  Mouse 

Determine  display  page 

Determines  the  display  page  cm  which  the  mouse  pointer  appears. 

Input  AX=  OOIEH 

Output:  BX=  Numba  of  the  display  page 

Interrupt  33H,  function  IFH  Mouse 

Deactivate  mouse  driver 

Deactivates  the  current  mouse  driver  and  returns  the  address  of  the  previous 
interrupt  handlers  for  interrupt  33H. 

Input  AX=  OOIFH  ^ 

Output:  AX=  Error  status 

AX=FFFFH:  Error 
AX=00IFH:  O.K. 

ES  =  Segment  address  of  (vevious  event  handle* 

BX=  Offset  address  of  previous  event  handla* 

Remarks:  This  call  releases  any  previously  installed  and  active  mouse  driver 

interrupt  routines.  The  exception  to  this  is  the  handler  for  interrupt  33H, 
but  the  caller  can  reload  this  interrupt  vectm*  with  its  original  value  since 
this  address  is  returned  in  the  ES:BX  registo'  pair. 

Interrupt  33H,  function  20H  Mouse 

Activate  mouse  driver 

Activates  a  mouse  driver  previously  deactivated  by  function  IFH. 

Input  AX  =  0020H 

Output:  No  ou^ut 
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Interrupt  33H,  function  21H  Mouse 

Reset  mouse  driver 

Resets  the  mouse  driver,  disables  the  mouse  points'  and  disables  the  currently 
installed  event  handler. 

Input  AX=  0021H 

Output:  AX  =  Error  status 

AX=FFFFH:  Enor 
AX=0021H:  O.K. 

BX=  Number  of  mouse  buttons 

Remarks:  Unlike  function  OOH,  this  function  does  not  perform  a  total  mouse 

hardware  reset 

Interrupt  33H,  function  24H  Mouse 

Determine  mouse  type 

Determines  the  type  of  mouse  installed  and  the  version  number  of  the  mouse 
driver. 


Input  AX=  0024H 

Output:  BH  =  Whole  number  of  the  version  number 

BL=  Fraction  of  the  version  number 
CH=  Mouse  type 
CH=1:  Bus  mouse 
CH=2:  Serial  mouse 
CH=3:  Inport  mouse 
CH=4:  PS/2  mouse 
CH=5:  HP  mouse 
CL=  IRQ  number 
CL=0:  PS/2 

CL=2,  3, 4,  5  or  7:  IRQ  number  in  the  PC 

Remarks:  If  the  version  number  of  the  mouse  driver  is  for  example  6.24,  the  value 

6  is  returned  in  the  BH  register  and  the  value  24  is  returned  in  the  BL 
register. 
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Throughout  this  book  we  talked  about  numbers  notated  in  the  binary  and 
hexadecimal  systems  instead  of  the  ncnmal  decimal  system.  This  Appendix 
presents  a  Inief  introduction  to  these  numbn  systems. 

Decimal  system 

Before  explaining  the  new  number  systems,  you  should  know  the  base  concepts 
of  the  decimal  system.  The  decimal  number  1989  can  also  be  written  as 
1*100Q+9*100+8*10+9*1.  This  shows  that  if  you  number  the  digits  from  right 
to  left,  the  first  number  represents  a  column  of  ones,  the  second  number  represents 
a  column  of  tens,  the  third  number  rq)res^ts  a  colunm  of  hundreds  and  the  fourth 
number  represents  a  column  of  thousands.  The  numbers  increase  from  ri^t  to  left 
in  powers  of  10. 

The  flrst  digit  of  any  number  system  has  the  value  1.  The  factor  by  which  the 
value  increases  from  one  column  to  the  next  diffo's  among  the  number  systems. 
This  factor  corresponds  to  the  numbers  with  which  the  number  system  works.  The 
factor  is  10  with  the  decimal  system  because  ten  different  numbos  are  available  for 
each  digit  (0  to  9). 

This  principle  of  powers  for  each  column  also  applies  to  the  binary  and 
hexadecimal  systems. 

Binary  system 

Since  a  computer  recognizes  the  numbers  0  and  1  on  its  lowest  functional  level, 
the  binary  system  is  essential  to  computing.  The  value  of  the  numbers  double 
from  column  to  column  because  the  binary  system  only  uses  powers  of  two  for 
each  column  (i.e.,  the  numbos  0  and  1  inst^  of  the  numbers  0  to  9). 
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Now  let's  count  the  binary  places  starting  from  right  to  left  as  we  did  in  the 
decimal  example  described  almve.  The  first  (right  hancO  position  counts  as  one,  the 
second  as  two,  the  third  as  four  and  the  fourth  as  eight  The  places  thoi  follow  as 
16,  32, 64, 128,  etc. 

For  example,  11001  binary  converts  to  25  decimal,  or  the  equation 
l*16+l'*8+0*4+0*2+l*l. 

Hexadecimal  system 

Unlike  the  binary  system,  the  hexadecimal  system  operates  with  more  basic 
numbers  than  the  decimal  syst^.  This  system  counts  single  digits  fiom  0  to  F. 
Since  only  the  ten  numbers  of  the  decimal  system  are  able  to  rqxesent  a  numbo:, 
the  numbers  from  10  to  IS  in  hexadecimal  use  the  letters  A  to  F  in  addition  to  the 
numbers  0  to  9.  AH  stands  for  10,  BH  for  11,  CH  fw  12,  DH  fw  13,  EH  for  14 
andFHfcx  IS. 

By  using  16  numbers  or  letters  for  each  position,  the  value  by  which  each  position 
increments  is  16. 

The  first  position  has  the  value  1,  the  second  16,  the  third  2S6  and  the  fourth 
4,096. 

For  example,  the  hexadecimal  number  FB3H  converts  into  4,019  decimal,  or 
15*256+11*16+3*1. 

Hex  and  binary 

The  hexadecimal  system  and  the  binary  system  are  easily  converted  back  and  forth. 
For  example,  one  four-digit  binary  numbo'  converts  to  a  single-digit  hexadecimal 
number.  Because  of  this,  the  hex^ecimal  system  is  an  important  part  of  assembly 
language  programming.  It's  much  simpler  to  convey  a  byte  (an  eight-bit  number) 
using  two  hexadecimal  digits  than  it  is  for  the  developer  to  compute  a  16-bit 
binary  equivalent. 

This  book  denotes  all  binary  numbers  by  the  letter  (b),  and  all  hexadecimal 
numbers  by  the  letter  H. 

The  following  illustrations  should  help  explain  numbo*  systems  more  clearly. 
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Places 

5 

4 

3 

2 

1 

Decimal 

10000 

1000 

100 

10 

1 

Binary 

16 

8 

4 

2 

1 

Hexadecimal 

65536 

4096 

256 

16 

1 

Number  positions  in  each  number  system 


Decimal 

Binary 

Hexadecimal 

0 

0(b) 

OH 

1 

Kb) 

IH 

2 

10(b) 

2H 

3 

11(b) 

3H 

4 

100(b) 

4H 

5 

101(b) 

5H 

6 

110(b) 

6H 

7 

111(b) 

7H 

8 

1000(b) 

8H 

9 

1001(b) 

9H 

10 

1010(b) 

AH 

11 

1011(b) 

BH 

12 

1100(b) 

CH 

128 

10000000(b) 

80H 

129 

10000001(b) 

81H 

256 

100000000(b) 

lOOH 

1024 

10000000000(b) 

400H 

4096 

1000000000000(b) 

lOOOH 

65535 

1111111111111111(b) 

FFFFH 

Comparing  selected  numbers  in  each  number  system 
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8086,  8088,  80186,  80286,  80386 

Microprocessors  manufactured  by  the  Intel  Corporation.  They  are  upwardly 
ctxnpatible,  which  means  that  the  80836  can  execute  any  program  developed  for  an 
8086,  8088,  80186  or  80286  microinocessor.  However,  the  8088  can't  always 
execute  an  application  developed  for  one  of  the  later  microprocessors.  The 
processors  of  this  family  act  as  main  processors  fmr  diffoent  types  of  PCs. 

Address 

The  Intel-80xx  family  of  microinocessors  form  an  address  from  one  of  the  four 
segment  registers,  in  conjunction  with  another  register  or  a  constant  The  contents 
of  the  segment  register  becomes  the  segment  address,  and  the  other  registo-  or 
constant  becomes  the  offset  address.  Both  addresses  are  logical  addresses  that  are 
related  to  a  {rfiysical  address  (the  actual  number  of  a  memory  location).  This 
physical  address  can  be  determined  by  multiplying  the  segmoit  registw  by  16  and 
adding  the  offset  address. 

Address  area 

The  numba  of  memory  locations  addressable  by  a  microprocessor. 

Address  bus 

A  line  connecting  the  CPU  with  memoy  (RAM  and  ROM).  If  the  CPU  wants  to 
address  a  memory  location,  it  must  first  place  its  address  on  the  address  bus  in 
ordo*  to  set  the  "switches"  for  access  to  this  memory  location. 

Arena  header 

The  data  structure  which  precedes  the  memory  area  of  the  TPA  assigned  to  a 
program.  DOS  uses  this  area  to  store  the  memory  area's  size  and  other 
information. 
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ASCII 

Abbreviation  for  American  Standard  Code  for  Information  Interchange. 
ASCII  is  a  standardized  assignment  of  numbers  from  0  to  255  that  represents 
characters  (e.g.,  lettm,  numbers).  The  ASCII  codes  firwn  0  to  127  comprise  the 
standard  ASCII  character  set,  while  the  codes  &om  128  to  255  comprise  the 
extended  ASCII  character  set. 

Assembly  language 

A  small  numbw  of  simple  instructions  that  the  processor  can  understand.  Every 
higher  level  language  program  is  finally  translated  into  these  instructions  for 
processing  by  the  CPU. 

Asynchronous  data  transfer 

Also  known  as  serial  tranter.  Bytes  are  transmitted  and/or  received  bit  by  bit 
according  to  a  predetermined  transfer  protocol 


AT 


Abbreviation  for  Advanced  Technology.  AT  computers  have  an  80286 
processor. 

Attribute 

A  byte  following  each  character  that  defines  the  charact^s  cokK  and  t^ipearance  for 
display  on  the  screen. 

AUTOEXEC.BAT 

Filename  for  the  automatically  executing  batch  file  for  which  DOS  searches  during 
the  booting  process.  After  DOS  is  loaded  and  started,  it  searches  the  root  directory 
of  the  device  fi’om  which  it  booted  for  a  file  named  AUTOEXEC.B  AT.  During  the 
booting  process,  this  batch  file  executes  programs  and  parameters  through  the 
command  processor. 

Batch  files 

Text  files  saved  with  the  file  extension  .BAT.  These  files  contain  DOS  commands 
or  command  sequences.  Batch  file  execution  treats  these  commands  as  if  the  user 
had  entered  the  commands  from  the  keyboard. 

Baud 

A  measurement  of  data  transfer  speed.  One  baud  roughly  equals  one  data  bit  per 
second. 

BCD 

Abbreviation  for  Binary  Coded  Decimal.  This  number  represents  a  two-digit 
decimal  number  encoded  in  one  byte.  The  upper  four  bits  represent  the  most 
significant  digit  and  the  lower  four  bits  represent  the  least  significant  digit. 
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Binary  system 

The  number  system  understandable  by  a  computer  at  its  lowest  level.  Binary 
notation  counts  from  0  to  1.  The  first  position  of  a  binary  numba*  has  the  value  1, 
the  second  has  the  value  2,  the  third  has  the  value  4,  the  fourth  has  the  value  8, 
etc. 

BIOS 

Abbreviation  for  Basic  Input/Output  System.  It  ctmtains  the  device  drivers 
which  perform  access  to  the  poipheral  devices  such  as  the  keyboard,  monitor,  disk 
drives,  etc.  The  BIOS  is  located  in  addresses  FOOO:EOOO — F(XX):FFE¥. 

BIOS  interrupts 

Interrupts  lOH  to  17H  and  interrupt  lAH,  through  which  the  many  functions  of 
the  ROM-BIOS  can  be  called. 

BIOS  version 

Release  date  of  the  BIOS  as  stored  in  the  eight  bytes  starting  at  memory  location 
F0(X):FFFS.  This  version  appears  in  the  form  Month/Day/Year. 

Block  driver 

The  device  drivers  which  control  access  to  devices  that  process  data  in  data  blocks 
(disk  drives  and  hard  disks).  Block  drivers  are  addressed  through  a  \eViet  (drive 
specifier)  which  enables  one  block  driver  to  control  several  devices  with  different 
letters.  The  disk  driver  has  the  drive  specifio^  A:  and  B:,  while  the  hard  disk  drivo’ 
can  be  addressed  with  the  specifier  C:. 

Boot  sector 

Contained  on  every  mass  storage  medium  from  which  DOS  can  be  booted.  Sector 
0  contains  certain  information  and  a  short  program  which  loads  a  DOS  boot 
routine,  then  initializes  EKDS. 

Booting 

The  process  that  starts  after  the  uso*  has  switched  on  the  computer.  BIOS  tests  and 
initializes  the  various  circuit  chips  in  the  system,  then  loads  the  operating  system. 

BPB 

Abbreviation  for  BIOS  Parameter  Block.  The  BPB  defines  the  format  and 
design  of  a  mass  storage  device  (disk  drive  and  hard  disk)  for  DOS.  It  is  available 
in  the  boot  sector  of  every  mass  storage  device,  but  must  be  passed  to  DOS  by  the 
initialization  routine  of  a  block  device  driver. 

CALL 


Assembly  language  instruction  that  triggers  the  execution  of  a  subroutine.  After 
the  routine  ends,  a  RET  instruction  executes,  which  is  followed  by  the  instruction 
following  the  initial  CALL. 
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Carry  flag 

Bit  0  in  the  processor’s  flag  register.  Many  operating  system  functions  use  it  to 
tell  the  calling  program  whether  the  called  fimction  executed  correctly,  ot  if  an 
error  occurred.  In  the  latter  case,  the  carry  flag  is  set  (1)  after  the  function  call. 

Character  driver 

A  device  driver  which  controls  access  to  devices  diat  jxocess  characters  as  bytes. 
The  screen,  keyboard  and  printer  ate  device  drivos.  Character  drivos  have  their  own 
names,  such  as  CON,  PRN  and  AUX. 

Child  program 

A  program  which  is  called  by  another  program.  For  example,  if  the  FORMAT 
command  is  called  from  the  DOS  level,  the  parent  program  is  the  command 
processor. 

CLI 

Clear  interrupts  instruction.  This  instruction  instructs  the  CPU  to  ignore  all 
subsequent  interrapt  requests  until  the  STI  (STart  Interrupts)  instruction  re-oiables 
interrupt  response  (the  NMI  [Non-Maskable  Interrupt]  is  exempt  from  this 
instruction). 

Clock  driver 

A  character  device  responsible  for  getting  the  time  and  date  from  DOS, 
incrementing  the  time  and  date  and  passing  the  incremented  amounts  back  to  DOS. 

Clock  generator 

Produces  several  million  pulses  per  second  and  synchronizes  various  components 
of  the  system  with  each  otho’. 


Cluster 


Multiple  sectors  of  a  mass  storage  device.  Files  and  subdirectories  can  be  stored  in 
different  clusters.  The  number  of  sectors  per  cluster  varies  from  one  device  to 
another. 

COM  files 

Executable  programs  which  must  be  stored  within  a  64K  memory  segment  COM 
files  combine  program  code,  data  and  stack  in  this  64K  area. 

COMMAND.COM 

The  file  containing  the  MS-DOS  command  processor. 

Command  line 

A  line  from  which  program  or  batch  file  calls  can  be  entered  into  the  conunand 
processor. 
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Command  parameters 

The  name  for  all  charactos  passed  in  the  command  tine,  following  the  {nogram  or 
batch  file  calls.  The  EXEC  function  copies  these  parameters  into  the  PSP  of  the 
loaded  program. 

Command  processor 

Also  called  shell.  The  command  processor  is  a  part  ot  the  opiating  i^stem  which 
accepts  and  processes  usa  input.  Its  main  function  is  to  load  and  start  application 
programs  and  batch  files. 


CON 


Abbreviation  for  CONsoIe  driver,  the  two  device  drivers  which  control  the 
keyboard  and  the  screen. 

CONFIG.SYS 

The  DOS  configuration  file.  It  contains  certain  commands  for  configuring  DOS,  as 
well  as  additional  device  drivers.  CONFIG.SYS  loads  and  executes  only  once 
(during  the  booting  process). 

Control  characters 

ASCII  characters  which  represent  certain  non-alphanumoic  characters.  This  applies 
to  all  ASCII  codes  less  than  32.  The  PC  only  uses  ASCII  codes  0, 7,  8, 9, 10, 1 1, 
12  and  13  as  cmitrol  charactns. 

Cooked  mode 

Character  mode  that  checks  for  certain  unusual  characters,  which  are  either 
converted  to  other  characters  or  completely  filtoed  out  Character  drivos  operate 
either  in  raw  mode  or  cooked  mode. 

CP/M-80 

Early  operating  system,  the  predecessor  of  MS-DOS.  CP/M  is  used  by  computers 
that  are  based  upon  Z-80  microprocessors. 


CPU 

Abbreviation  for  Central  Processing  Unit.  The  microprocessor  which  forms 
the  "brain"  of  a  computer. 

CRC 

Abbreviation  for  Cyclical  Redundancy  Check.  The  CRC  tests  for  errors 
during  data  transfer  to  and  from  a  disk. 
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CRT 

Abbreviation  for  Cathode  Ray  Tube.  A  CRT  generates  a  screen  display  with 
the  help  of  an  election  beam  which  soids  electrical  impulses  to  a  glass  screen  at 
the  end  of  the  CRT. 

DASD 

Abbreviation  for  Direct  Access  Storage  Device.  In  DOS  and  BIOS 
tominology  this  concept  is  used  for  disk  drives  and  hard  disks. 

Data  bus 

A  data  line  which  connects  the  CPU  with  memory  (RAM  and  ROM).  Data  can  be 
transmitted  between  the  CPU  and  memwy  over  this  line. 

Device  driver 

Driver  systems  which  interface  DOS  and  hardware  by  making  basic  functions 
available  for  communicating  with  the  hardware.  Device  driver  functicms  can  be 
called  by  the  higher  level  DOS  functions.  DOS  differentiates  between  character 
driv^  and  block  drives. 

Disks 

Flat  plastic  materials  containing  magnetic  media  for  storing  data.  Formatted  disks 
are  partitioned  into  tracks  and  sectors. 

Disk  controller 

Regulates  the  activities  of  the  disk  drive. 

Disk  status 

Lists  the  status  of  the  last  disk  operation.  It  indicates  if  and  when  an  error  occurred 
during  this  disk  access. 

Disk  formats 

The  PC  market  supports  several  disk  formats.  PC  and  XT  disk  drives  use  5-1/4" 
disks  that  are  formatted  on  one  or  two  sides.  Each  side  contains  40  tracks  with 
eight  or  nine  sectors  per  track  (each  sector  stores  512  bytes).  The  ctqracity  of  these 
disks  is  between  160K  (single-sided)  and  360K  (double-sid^).  The  AT  uses  5-1/4" 
disks  with  two  formatted  sides,  each  side  containing  80  tracks  with  15  sectors  per 
track  (each  sector  stores  512  bytes).  The  total  capacity  of  these  disks  is  1.2 
megabytes. 

The  newest  disk  formats  on  the  market  allow  the  use  of  3-1/2"  mioo  floppy  disks. 
Display  page 

Also  called  screen  page  and  video  page.  Some  video  cards  can  control  one  <w  more 
display  pages.  Only  one  of  these  pages  can  be  displayed  on  the  screoi  at  one  time. 
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DMA 

Abbreviation  for  Direct  Memory  Access.  Transmits  data  from  the  circuit 
chips  of  a  peripheral  device  directly  into  memory,  without  malting  a  detour 
through  the  CPU.  ^  ' 

DMA  controller 

A  chip  capable  of  transforing  large  amounts  oi  data  directly  into  memcny  without 
passing  through  the  CPU.  A  good  example  is  the  access  to  a  di^  drive  (xc  hard 
disk  drive. 

DOS 

Abbreviation  for  Disk  Operating  System.  DOS  sets  up  basic  file  handling 
tasks  for  communicating  between  computer  and  disk  drive(s). 

DTA 

Abbreviation  fw  Disk  Transfer  Area.  File  and  directory  accesses  use  the  DTA 
for  disk  data  transmission.  Its  size  depends  upon  the  current  opa7.tion,  where  the 
calling  program  must  oisure  that  enough  memory  exists  to  accept  the  transmitted 
data.  After  the  start  of  a  program,  DOS  places  the  beginning  of  the  DTA  into 
memory  location  128  of  the  PSP,  which  makes  128  bytes  available. 

ECC 

Abbreviation  for  Error  Correction  Code.  ECC  is  used  whoi  data  is  stored  on  a 
hard  disk.  Unlike  the  CRC,  the  ECC  permits  the  recognition  of  errors  as  well  as 
their  correction  within  c^tain  paramet^. 

EGA 

Abbreviation  for  Enhanced  Graphic  Adapter.  This  is  a  special,  high 
resolution  variation  on  the  Color/Graphics  Adt^ter  (CGA). 

EMM 

Abbreviation  for  Expanded  Memory  Manago*.  Allows  access  to  EMS  memcny. 

EMS 


Abbreviation  ioi  Expanded  Memory  System.  This  section  of  RAM  goes  beyond 
the  1  megabyte  limit  set  by  PCs  and  XTs.  EMS  is  only  accessible  through  the 
EMM. 

End  character 

Also  called  return  code.  The  end  character  is  ASCII  code  0,  which  is  sometimes 
assigned  the  name  NUL.  It  usually  indicates  the  last  character  in  a  character  string. 
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Environment  block 

Every  program  has  an  assigned  environment  block  whose  address  is  suxed  in  the 
PSP  of  the  current  program.  The  environment  block  itself  consists  of  a  series  of 
ASCII  strings  which  contain  certain  information,  such  as  the  search  path  fw  files 
(PATH). 


EOI 


Abbreviation  for  End  Of  Interrupt.  This  instruction  indicates.the  completion  of 
a  hardware  triggoed  intorupt  to  the  interrupt  handler. 

Extended  key  code 

Keys  and  key  combinations  that  can  be  entered  with  a  PC  keyboard  but  have  no 
direct  relation  to  the  ASCII  charactn  set  They  are  often  entered  by  pressing  and 
holding  the  <Alt>  key,  then  entering  a  three-digit  numbo'  on  the  numeric  keypad. 

EXE  files 

Executable  programs  which  can  be  of  any  length  and  can  store  their  code,  data  and 
stack  in  different  memory  segments  (see  also  COM  files). 


EXEC 


DOS  function  for  loading  and  executing  programs.  The  command  processcv  also 
uses  this  function  to  execute  applications  programs  and  batch  files. 

FAR  instructions 

Machine  language  instructions  that  contain  an  address  of  a  variable  or  a  subroutine 
with  a  segment  address  and  an  offset  address.  They  can  address  variables  or 
subroutines  located  in  another  memory  segment  (farther  away  than  64K). 

FAT 

Abbreviation  for  File  Allocation  Table.  This  is  a  table  located  on  every 
external  storage  medium  (disk  and  hard  disk).  It  informs  DOS  which  areas  of  a 
storage  medium  are  available,  which  areas  are  already  occupied  with  data,  and 
which  areas  are  useless  because  of  defects.  The  FAT  also  links  together  the 
different  parts  of  a  file. 

FCB 


Abbreviation  for  File  Control  Block.  DOS  controls  file  access  to  RAM  using 
FCBs. 

Fixed  disk 

Anotha  tom  for  hard  disk. 
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Filter 

A  program  that  reads  characters  from  the  standard  input  device,  manipulates  them 
in  some  desired  way,  and  then  displays  them  on  the  standard  ouQnit  device. 

Flag  register 

A  16-bit  register  in  which  several  of  these  bits  indicate  colain  aspects  of  the 
processor's  status. 

Function 

A  routine  that  can  be  called  with  a  DOS  or  BIOS  intmupt 
Garbage  collection 

A  routine  that  removes  variables  which  are  no  longer  required  from  the  variable 
memory  of  a  BASIC  program.  Every  BASIC  interpreto*  has  garbage  collection. 


GDT 


Abbreviation  for  Global  Descriptor  Table.  The  GDT  describes  the  individual 
memory  segments  when  the  processor  is  in  protected  mode. 

General  registers 

The  processors  of  the  Intel-80xx  family  have  the  following  general  registos:  AX, 
BX,  CX,  DX,  DI,  SI  and  BP.  They  are  all  16  bits  wide.  The  AX,  BX,  CX  and  DX 
registers  can  be  separated  into  two  8-bit  registers.  These  two  half  registers  are 
designated  as  AH,  AL,  BH,  BL,  CH,  CL,  DH  and  DL. 


Handle 

A  nummcal  value  that  acts  as  a  key  for  access  to  files  and  devices.  It  is  passed  by 
DOS  to  a  program  which  calls  one  of  the  functions  for  opening  or  creating  a  file 
OT  device. 

Hard  disk 

A  mass  storage  unit  consisting  of  several  magnetic  media  stacked  on  top  of  one 
another.  Unlike  disks,  hard  disks  are  divided  into  cylindos  and  sectors.  Each  of 
these  disks  can  store  data  on  both  their  top  and  bottom  sides. 

Hard  disk  format 

The  PC  hard  disk  format  consists  of  17  sectors  per  cylinder  and  512  bytes  per 
sector.  The  number  of  disks  and  the  number  of  cylindos  per  disk  may  vary. 

Hardware  interrupt 

An  interrupt  or  interrupt  request,  called  by  PC  hardware,  to  attract  the  attention  of 
the  CPU  to  a  device  (e.g.,  the  keyboard).  Certain  devices  only  call  certain 
interrupts. 
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Hexadecimal  system 

A  number  system  distantly  related  to  the  binary  systmn.  The  basic  numbming  of 
this  system  goes  from  0  to  IS.  instead  of  from  0  to  9  (the  numbers  10  to  IS  are 
represented  by  the  letters  A,  B,  C,  D,  E  and  F).  The  first  position  of  a  hexadecimal 
number  has  the  value  1,  the  second  16,  the  third  2S6,  die  fourth  4,096,  etc. 


IN 


Assembly  language  instruction  to  read  data  from  a  port  into  the  CPU. 
laternal  commands 

All  commands  whose  code  is  stored  in  the  transient  pmtion  of  the  command 
processor,  and,  therefore,  don't  have  to  be  loaded  from  a  storage  medium  (e.g., 
DIR,  COPY  and  VER). 

Interrupt  ^ 

An  interruption  of  a  program  through  an  interrupt  call,  the  execution  of  an 
interrupt  routine  and,  finally,  the  resumption  of  the  interrupted  {xogram.  The 
processors  of  the  Intel-80xx  family  can  process  2S6  differoit  interrupts  which  are 
divided  into  hardware  and  software  intnrupts. 

Interrupt  controller 

Monitors  the  various  interrupt  requests  within  the  system  and  decides  which 
interrupts  to  process  first. 

Interrupt  routine 

The  program  called  during  the  appearance  of  an  interrupt.  Each  interrupt  has  its 
own  interrupt  routine,  whose  add^s  is  stored  in  the  interrupt  vector  table.  The 
interrupt  routine  must  be  terminated  with  a  machine  language  IRET  instruction. 

Interrupt  vector  table 

A  table  containing  the  addresses  of  the  intorupt  routines,  which  ate  called  whoi  a 
particular  interrupt  appears.  Each  entry  in  this  table  consists  of  two  words.  The 
first  word  contains  the  offset  address  and  the  following  wmd  contains  the  segment 
address  of  the  interrupt  routine.  The  table  starts  at  memory  location  (XXX):0000, 
where  the  address  of  the  interrupt  routine  for  interrupt  0  is  stored.  The  four 
following  memory  locations  contain  the  address  of  the  interrupt  routine  for 
interrupt  1,  etc. 


IRET 


The  Interrupt  RETum  assembly  language  instruction.  IRET  terminates  the 
execution  of  an  intorupt  routine  and  then  continues  the  execution  of  the  i»ogtam 
at  the  location  following  the  intoruption  of  the  program. 
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Keyboard  status 

Indicates  whether  the  user  has  pressed  the  <Shift>,  <Ctrl>  <w  <Alt>  keys,  and 
whether  the  <Insert>,  <CapsL(Kk>,  <NumLock>  or  <ScrollLock>  mo^  are 
active. 

Kilobyte 

Abbreviated  as  K.  Equals  2^^  or  1,024  bytes. 

Math  coprocessor 

S 

Relieves  the  CPU  of  the  processing  of  complicated  floating-point  mathematical 
formulas.  It  also  accelerates  the  processing  of  worksheets  within  a  spreadsheet 
program. 

Megabyte 

Often  abbreviated  as  meg.  Equal  to  2^^  kilobytes  (mt  1,048,576  bytes. 

Media  descriptor  byte 

A  byte  within  the  File  Allocation  Table  (FAT),  which  identifies  the  mass  storage 
device's  current  format.  DOS  can  manipulate  the  various  formats  of  the  mass 
storage  which  it  supports  and  also  checks  the  media  descriptor  byte  for  the  currrat 
format. 

Memory  allocation 

In  all  PCs  the  lower  640K  is  assigned  to  RAM.  The  video  RAM  foUows,  and  then 
the  ROM,  which  extends  to  the  1  megabyte  memory  limit  ATs  may  have  up  to 
IS  megabytes  of  additional  RAM. 

Microprocessor 

The  brain  of  a  computer.  Its  main  task  is  to  execute  assembly  language 
instructions. 

Model  identification 

The  type  of  PC  used,  as  coded  into  address  FOOOtFFFE.  FCH  stands  for  AT,  FEH 
often  stands  fw  XT  and  FFH  often  stands  for  PC. 

MS-DOS 

Abbreviation  for  Microsoft  Disk  Operating  System.  MS-DOS  is  the 
primary  PC  operating  system. 

Multiprocessing 

The  simultaneous  execution  of  several  programs  (not  supported  by  DOS  at  the 
time  of  this  writing). 


913 


Appendix  H:  Glossary  cf  Terms 


PC  System  Programming 


NEAR  instructions 

Assembly  language  instructions  that  contain  the  offset  address  of  only  a  variable  or 
a  subroutine  (no  segment  address).  These  instructions  can  address  variables  at 
subroutines  located  only  within  the  current  64K  memmry  segment 

Nibble 

Also  spelled  nybble.  Bytes  can  be  subdivided  into  two  nibbles.  The  low  nibble 
occupies  bits  0  to  3  of  a  byte,  while  the  high  nibble  occiq)ies  bits  4  to  7  of  a  byte. 

NMI 

Abbreviation  for  Non*Maskable  Interrupt.  The  NMI  remains  constantly 
active.  It  is  the  only  interrupt  not  affected  by  the  CLI  assembly  language 
insUnction. 

OUT 

An  assembly  language  insmiction  which  sends  data  to  a  port. 

Overlay 

A  program  loaded  into  memory  allocated  for  it  by  another  program.  The  calling 
program  calls  certain  routines  within  this  ovalay  as  needed. 

Paragraph 

A  group  of  16  bytes  in  the  8088  which  starts  at  a  memory  location  divisible  by  16 
(e.g.,  0,  16,  32,  48,  etc.). 

Parent  program 

A  program  that  can  execute  another  program  (see  child  program)  and  continue  its 
own  processing  after  the  child  program's  execution.  For  example,  if  a  FORMAT 
command  is  called  from  DOS  level,  the  command  processor  is  the  parent  program. 

Parity 

A  process  used  to  detect  mors  during  serial  data  transmission.  Either  even  at  odd 
parity  can  be  used. 

PC 

Abbreviation  for  Personal  Computer  (i.e.,  all  computers  equipped  with  a  8088 
or  8086  processor). 

Peripheral  interface 

Connects  the  CPU  to  various  peripheral  devices  (e.g.,  speaks). 
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Ports 

The  connections  between  the  CPU  and  various  Mher  circuit  chips  within  the 
system.  Each  chip  has  one  or  more  assigned  ports,  which  have  a  q)ecific  address. 
The  CPU  addresses  the  individual  chips  by  writing  values  into  the  im>per  p(»t  or 
by  reading  values  from  the  propa*  port 

Printer  status  byte 

Describes  the  current  status  of  the  printer.  It  can  indicate  whether  the  juintN  is  out 
of  paper,  is  switched  ONLINE  or  has  not  responded  (time-out). 


PRN 


The  device  designation  of  the  printo'. 

Program  counter 

Also  called  IP  (Instruction  Pointer).  The  program  counter  and  the  CS  segment 
register  combined  form  die  memmy  address  from  which  the  processw  will  read  the 
next  command  to  be  executed. 

Protected  mode 

Allows  multiprocessing,  more  than  1  megabyte  of  memory  and  control  over 
virtual  memory  on  computers  possessing  the  80^  and  80386  processors. 


PSP 

Abbreviation  for  Program  Segment  Prefix.  The  PSP  is  a  256  byte  long  data 
structure,  which  is  placed  in  front  of  evoy  program  to  be  executed  but  not  stored 
with  the  file  on  dislc  or  hard  disk.  The  program  itself  ex'  program  data  start  after 
this  data  structure. 

RAM 


Abbreviation  for  Random  Access  Memory.  This  is  the  memory  that  the  user 
can  read  from  and  write  to. 

Raw  mode 

Character  mode  that  transmits  all  charactos  from  a  device  to  the  calling  program 
without  any  changes  (see  cooked  mode). 

Real  mode 

Forces  80286  and  80386  processors  to  emulate  dual  high-speed  8088  processors 
incapable  of  multiprocessing  or  control  of  more  than  1  megabyte  of  memory. 

Register 

Memory  locations  inside  the  processor  that  provide  faster  access  than  memory 
locations  in  RAM. 
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Reset 


A  resetting  and  reboot  of  the  system.  You  can  trigger  a  reset  by  pressing  the 
<AltxCtrlxDelete>  key  combination. 

Resident 

Programs  that  remain  in  memory  after  execution  without  being  overwritten  by 
otho*  programs  or  data.  Resident  programs  can  be  recalled  later. 


ROM 

Abbreviation  for  Read  Only  Memory.  ROM  can  only  be  read,  not  written. 
ROM  BASIC 

A  small  BASIC  interpreter,  placed  in  the  ROMs  of  older  PCs  starting  at  address 
F000:6(X)0.  ROM  BASIC  is  called  by  the  system  when  BIOS  fails  to  load  the 
operating  system. 

RS-232 

An  interface  that  permits  the  compute  to  communicate  with  other  devices  over 
only  one  line.  The  individual  data  is  transmitted  serially  (i.e.,  bit  by  bit). 


RTC 

Abbreviation  for  RealTime  Clock.  The  battoy  backed  clock  on  the  AT. 

Scan  code 

A  code  passed  to  the  CPU  by  the  keyboard  processor  when  a  key  is  pressed  or 
released.  It  indicates  the  number  assigned  to  the  key  within  the  keyboard.  For  this 
reason,  the  scan  codes  of  the  various  PC  keyboards  dififo'  fircxn  each  otho-. 


Sector 


The  smallest  data  division  of  a  disk  or  hard  disk.  A  sector  contains  512  bytes. 
Segment  descriptor 

Describes  the  location  and  size  of  the  segment  in  addition  to  other  information.  It 
is  used  in  protected  mode  on  the  80286  and  80386  processors.  All  segment 
descriptors  are  gath^ed  in  the  global  descriptor  table  (GDI). 

Segment  register 

The  processors  of  the  Intel-80xx  family  have  four  16-bit  segm^ts  that  define  the 
beginning  of  a  64K  memory  segment.  They  are  named  DS,  ES,  CS  and  SS. 

Software  interrupts 

An  interrupt  or  interrupt  request  called  by  a  program  using  the  INT  instruction. 
Each  of  the  256  existing  intorupts  can  be  call^  using  this  instruction. 
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Standard  input  device 

The  keyboard.  The  standard  input  can  be  redirected  to  anotho'  device  or  a  fiie  using 
the  <  character. 

Standard  output  device 

The  monito' screen.  The  standard  ouqwt  can  be  redirected  to  another  device  or  a  file 
using  the  >  characto'. 


STI 

The  STart  Interrupts  assembly  language  instruction.  This  instruction  disables 
any  previous  CLI  command  and  re-enables  all  inactive  interrupts. 

Time-out 

Occurs  during  communication  between  the  CPU  and  a  device  whoi  the  CPU  sends 
data  to  the  device  and,  after  a  certain  amount  of  time,  the  device  offers  no  response. 

Timer 

Similar  to  the  clock.  The  tima  generates  a  cyclical  signal  used  to  measure  time. 

TPA 

Abbreviation  for  Transient  Program  Area.  This  is  the  part  of  RAM  below  the 
1  megabyte  limit  not  occupied  by  DOS  that  is  used  for  sttning  programs  and  data. 

UART 


Abbreviation  for  Universal  Asynchronous  Receiver  Transmitter.  A  chip 
that  acts  as  the  controller  for  the  serial  interface. 

Video  controller 

Displays  a  picture  on  the  screoi  by  sending  the  proper  signals  to  the  monitor. 
Video  RAM 

RAM,  which  is  used  for  storing  characters  or  graphics  for  display  on  the  screen, 
made  available  by  a  video  card.  It  can  be  addressed  like  nonnal  RAM. 

Virtual  memory 

Permits  program  access  to  memory,  which  it  assumes  to  be  RAM  but  is  actually  a 
mass  storage  device.  Virtual  memcxy  must  first  be  loaded  into  RAM  for  access. 

Volume 

Part  of  a  mass  storage  device  that  has  files,  its  own  FAT,  its  own  root  directory 
and  its  own  subdirectories.  Each  volume  can  have  its  own  volume  name.  While 
disks  can  store  only  one  volume  under  DOS,  hard  disks  can  be  divided  into  several 
volumes  to  accommodate  several  operating  systems. 
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Interrupt  ISH,  function  83H 

7S2 

Byte  table 

840 

Intmupt  ISH,  function  84H 

7S3 

Interrupt  ISH,  function  8SH 

7S4 

C  language 

104 

Interrupt  ISH,  function  86H 

7S4 

CALL 

90S 

Interrupt  ISH,  function  87H 

7S4 

Call  ROM  BASIC 

71S,  7S9 

Intnrupt  ISH,  function  88H 

7SS 

Calling  interrupts 
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Cancel  all  files  in  print  queue  848 

BIOS  Interrupts  (XT  and  AT  only): 

Cancel  redirection 
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Interrupt  I3H,  function  (X)H 
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Carry  flag 

12,  37, 90S 

Intmupt  13H,  function  OAH 

744 

Cassette  interrupt 

297,  336 

Interrupt  13H,  function  OBH 

74S 

Cathode  ray  tube 
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Interrupt  13H,  function  ODH 
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CD-ROM 
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CGA 

2S4, 463 
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121 
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738 

Change  directory 

93 

Interrupt  13H,  function  04H 

740 

Change  retry  count 

819 

Interrupt  13H,  function  OSH 

741 

Character  device  driver 

ISO,  170,  194, 

Interrupt  13H,  function  08H 

742 

81S,906 

IntOTupt  13H,  function  09H 

743 

Character  generator 

460,  87S 

Interrupt  13H,  function  lOH 

747 

Character  input 

766,  774,  777 

Interrupt  13H,  function  IIH 

748 

Character  matrix 

469 

Interrupt  13H,  function  14H 

748 

Character  output 

70,  767,  774 

BIOS  keyboard  functions 
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26S,  4S9,  872 

BIOS  memory  functions 

713 

Character  table 

71S,  76S 

BIOS  Parallel  printer  functions 

71S 

Child  program 

110,906 

BIOS  Parameter  Block  (BPB)  1 S7, 

160, 

CHKDSK 

201 

198,  214,  21S,  90S 

CLI 

23 

BIOS  printer  interrupt  38S,  7 IS 

Clock 

14,906 

BIOS  screen  ouq)ut 

226 

Close  file  (FCB) 

782 

BIOS  serial  interface  functions 

714 

Close  file 

808 

BIOS  time  functions 

39S 

Clusters 

198,  906 

BIOS  variable  memory 

398 

Code  segment 

10 

BIOS  version 

223 

Color  palette 

498,  721,  723 

Bitfield 

887 

Color  selection  register 

S04,  871 

Bitmap  mode  460,  721 

Color-suppressed  mode 

498 

Bitplanes 

S21 

Color/Graphics  Adapter  (CGA)  228, 

Blinking  attribute 

866 

2S4,  497 

Block  device  driver  150,  156, 

171, 

COM  programs 

SI,  60,  62,  112, 

194,  816,  90S 

82S,  906 

Boot  sector  S9,  18S,  197,  90S 

COMl 

73 

Booting  221,  71S,  7S9,  90S 

Command  processor 

S3,  S6,  111,907 

Bootstrap  198, 221 

COMMAND.COM 

S6,  111,823,  906 

BcMder  color 

862 

Common  registers 

6 

BPB — see  BIOS  Parameter  Block 

Compact  disk  (CD) 

193 

<Break>key  7 IS,  763 

Compatibility 

206 

Brealqxrint  668-669, 711 

COMSPEC 

112 

Buffer 

814 

CONFIG.SYS 

S9,  8S,  149,  1S6, 

Buffoed  input 

779 

194,  907 
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Configuration 

289 

Configuration  register 

482 

Control  codes 

233 

Control  recod  access 

835 

Control  register 

471 

ControUa  diagnostic 

748 

Co(*edmode  72.  150,  171, 814,  907 

G)iintry-specific  data 

769,  770 

CP/M  51-52,  70.  84.  687,  907 

Create  file 

786,  806,  835 

Create  new  file 

835 

Create  PSP 

793 

Create  subdirectory 

804 

Create  temporary  file 

834 

Critical  error  handler  57,  142,  800,  842 

Critical  OTor  handler  address  843 

CRT 

458,  908 

CRT  controller  (CRTC) 

14,  460, 

462,  857,  872 

<Ctrl>  key 
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<Ctrl><Break> 

800 

Cursor  definition  232,716,856,857 

Cursor  positioning 

232,  717,  857 
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447 

Cyclic  Redundancy  Check 

324,  907 

DAC  color  register 

867 

DAC  color  table 
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DAC  mask  register 

870 

DAC  register  group 

868 
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908 

Data  bus 

16.  699,  908 

Data  segment 

10 

Data  structures 

196 

Data  transfer  protocol 

330 

Date  54,  395,  715, 759-762, 

796,  797,  829 

DEBUG  program 

172 

Decimal  system 

900 

Define  cursor  type 

233,  716 

Delete  file  (FCB) 

784 

Delete  file 
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Delete  subdirectory 

805 
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727 

Determine  disk  format 

735 
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Determine  Format  of  the  Hard  Disk  742 
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Determine  memory  size  728, 755 
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Device  driver  access  1 5 1 , 767 

Device  redirection  838 

Devices  53 

Digital  Research  52 

DIR  command  96 

Direct  console  I/O  776 

Direct  Memory  Access  (DMA)  13,  325, 

909 

Direct  video  access  457 

Directory  lister  programs  96 

Directory  search  93 

Disable  lightpen  emulation  889,  890 

Disable  mouse  pointer  883 

Disk  access  297, 769 

Disk  change  303,  735 

Disk  controller  14, 908 

Disk  format  735,  742, 908 

Disk  monitor  program  305 

Disk  operating  system  51 

Disk  reset  781 

Disk  status  730, 908 

Disk  transfer  area  (DTA)  62,  90 

Disk/hard  disk  access  769 

Display  attributes  460 

Display  modes  458 

Display  mouse  pointer  882,  883 

Display  page  856-858,  908 

Division  by  zero  710 

DMA  13,  325,  909 

DOS  4.0  213 

DOS  201 

DOSbuffer  211 

DOS  flag  access  769 

DOS  functions  96, 206 

DOS  Info  Block  (DIB)  208 

DOS  Interrupt  21H,  function  5CH  835 

DOS  kernel  56 

DOS  version  number  799 

DOS-BIOS  56 
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Drive  infomation  789 

Drive  Parameter  Block  (DPB)  209 

Drive  table  715, 764 

Driver  initialization  148,  156 

DTA  62,  99,  768,  788,  827,  909 

DUMP  program  134 

Duplicate  handle  820 

EGA  254,  463,  909 

EGA  attribute  controller  865 

EGA  BIOS  254 

EGA  character  generator  263 

EGA  functions  856 

EGA/VGA  conriguration  856,  877 
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Electron  beam  461 
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Interrupt  67H,  function  5  851 

Interrupt  67H,  function  6  851 

Interrupt  67H,  function  7  852 

Interrupt  67H,  function  8  852 

Interrupt  67H,  function  9  853 

Enable  mouse  pointer  882,  883 

End  charactCT  909 

End  of  Interrupt  (EOI)  670,  910 

Environment  block  1 12, 208, 823, 9 10 
Error  Correction  Code  (ECC)  324,  909 
Error  display  71 

Exchange  mouse  event  handlers  892 
Exclusion  area  621,  890, 891 

EXE  programs  51,  60,  66,  112 

825, 910 

EXEC  function 

60,  66, 110,  132,  823,  910 
Execute  overlay  824 

Execute  program  823 


Expanded  Memory  Manager  (EMM) 

849,  852,909 

Expanded  Memory  Specification  (EMS) 

213,909 


Expanded  memory  allocation  850 

Expanded  memory  handles  854 

Expanded  memory  moping  851 

Expanded  memay  segment  address  849 
Expanded  memory  status  849 

Extended  FCB  88 

Extended  keyboard  codes  360, 910 
Extended  memory  allocation  850 

Extended  memwy  mapping  851 

Extended  memory  segment  address  849 
Extended  memory  status  849 

Extended  MS  system  page  850 

Extended  partitions  688 

Extended  read  744 

Extended  write  745 

External  commands  57 

External  hardware  interrupt  23 

Extra  segment  11 

FAR  instruction  1 15, 910 

FAT — see  File  Allocation  Table 
FCB  functions  84,  91,  206,  768 

FCB — see  File  Control  Block 
File  access  (FCB)  768 

File  access  (handle)  768 


924 


Abacus 


Index 


File  Allocation  Table  (FAT) 

53,  194, 

Get  system  date/time 

796.797 

198, 214, 910 

Get  verify  flag 

828 

File  Control  Block  (FCB) 

55.  62.  84. 

Get  video  mode 

232 

208 

GRAFTABL 

234,  721, 764 

File  date 

830 

Graphic  mode 

458 

File  handle  55. 70,  85,  768,  820 

Graphic  user  interfaces 

213 

File  information  access 

769 

Gray  scales 

871,  878,  879 

File  search  using  FCB  functions  94 

GW-BASIC 

28 

File  search  using  handle  functions  95 

File  time 

830 

Handle 

70,815,911 

Filters 

132,911 

,  Handle  functions 

96 

Fixeddisk  54,741,910 

Harddisk 

54, 323 

Flag  register 

6,  12,911 

Hard  disk  error  codes 

324 

Flush  input  buffers 

162,  164 

Hard  disk  format 

911 

Flush  output  buffers 

164 

Hard  disk  function  calls 

325 

Force  duplicate  of  handle 

820 

Hard  disk  interrupts 

674 

F(M*eign  hard  disks 

743 

Hard  disk  partition  support 

213,  687 

FORMAT 

202 

Hardcopy 

670,711 

Format  diskette 

733 

Hardware  intonipt  22,  667,  710,  911 

Format  hard  disk 

326,  741 

Hardware  (CPU)  Interrupts: 

Format  hard  disk  cylinder 

741 

Interrupt  OOH 

710 

Function 

911 

Interrupt  OlH 

710 

Interrupt  02H 

711 

Garbage  collection 

30,911 

Interrupt  03H 

711 

GDT 

337,911 

Interrupt  04H 

711 

General  registers 

911 

Interrupt  05H 

711 

Get  <Clrl><Break>  flag 

800 

Interrupt  08H 

Get  allocation  strategy 

830 

(8259  interrupt  controller)  712 

Get  country 

802 

Interrupt  09H 

Get  current  directory 

93,  821 

(8259  interrupt  controller)  712 

Get  default  drive 

788 

Heap 

432 

Get  device  information 

813 

Hercules  graphic  cards 

230,  255, 

Get  Drive  information 

789 

463,  482 

Get  DTA  address 

798 

Hertz 

447 

Get  extended  error  information 

832 

Hexadecimal  system 

899,  912 

Get  file  attributes 

811 

Hidden  files 

96 

Get  file  date  and  time 

829 

Hierarchical  file  system 

54 

Get  free  disk  space 

801 

High  density  disk  drives 

303 

Get  input  status 

780 

High  level  languages 

3,711,712 

Get  interim  console  flag 

840 

Hold  print  jobs  for  status  check  848 

Get  machine  name 

836 

Horizontal  synchronization  signal  472 

Get  MS-DOS  version  number 

799 

Hotkey 

408 

Get  pointer  position/button  status  884 

Get  print  spool  install  status 

846 

I/O  Control  Read 

160 

Get  printer  setup 

837 

I/O  Control  Write 

165 

Get  PSP  address 

839 

IBMBIO.COM 

59, 202 

Get  redirection  list  entry 

837 

IN 

464,  699, 912 

Get  return  code 

826 

Initialize 

750 
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Initialize  printer 

385,  758 

Input  buffer 

575 

Input  status 

162,  817 

Installable  device  drivers 

55 

Instruction  pointer 

10 

INT  instruction  27, 47.  711,  712 

int86  function  (C) 

40-41 

intdos  function  (C) 

41-42 

intdosx  function  (C) 

40,42 

Intel  Corporation 

3,  712,  903 

interim  console  flag 

(840 

Interleave  factor 

210 

Internal  commands 

57.  912 

Internal  DOS  structure 

56 

Internal  hardware  interrupts 

23 

Interrupt  controller 

13,  670,  912 

Interrupt  requests 

13,  671 

Interrupt  routine 

20,  912 

Interrupt  vector 

801 

Interrupt  vector  table 

20,  912 

Interrupts 

19 

INTO  (INTemipt  on  Overflow) 

instruction  711 

INTR  procedure  (Pascal) 

36 

lO.SYS 

59 

lOCTL 

165,  170,  819 

IRET  (Interrupt  RETum) 

19,711 

JOIN 

212 

Joysticks 

753 

Keyboard  access 

72,  358,  712 

Keyboard  control^ 

576 

Keyboard  output  functions 

74 

Keyboard  programming 

575 

Keyboard  status 

913 

Kilobyte 

913 

LASTDRIVE 

212 

Lightpen 

713,  882,  889 

Logical  hard  disk 

688 

Logical  sector 

216 

Low-level  formatting 

687 

Macros 

48 

Make  directory 

93 

Maskable  interrupts 

23 

Match 

826-827 

Math  coprocessor 

14,675,710 

711,913 

MCB 

209 

MDA 

254, 463 

Media  change 

734 

Media  check 

158 

Media  descriptor 

199, 210. 913 

Megabyte 

8,  291,  913 

Memory 

16,  754 

Memory  block  allocation 

822,  831,913 

Memory  Control  Block 

119,208,209 

Memory  location 

16 

Memory  release 

121,  822 

Memory  segments 

17 

MicrojMOcessor 

3,  8,  575,  913 

Microsoft  Assembler  (MASM)  48 

Microsoft  C  compiler 

416 

Microsoft  Corporation 

52 

Microsoft  mouse 

617 

Mode  selection  register 

501,  502 

Model  identification  byte 

291,  913 

Modify  allocation  (Vers  2  and  up)  822 
Monochrome  Display  Adapter  (MDA) 

226, 463,  469,  482, 497 


Mouse  button  activation  counter 

884, 885 

Mouse  button  release  counter  885 


Mouse  button  status  883,  884 

Mouse  buttons  618 

Mouse  event  handlers  888,  89 1 

Mouse  interface  617 

Mouse  interrupts: 


Interrupt  33H,  function  OOH  882 

Interrupt  33H,  function  OAH  887 

Interrupt  33H,  function  OBH  888 

Interrupt  33H,  function  OCH  888 

Interrupt  33H,  function  ODH  889 

Interrupt  33H,  function  OEH  890 

Interrupt  33H,  function  OFH  890 

Interrupt  33H,  function  OlH  883 

Interrupt  33H,  function  1  AH  896 

Interrupt  33H,  function  IBH  897 

Interrupt  33H,  function  ICH  897 

InteiTupt  33H,  function  IDH  897 

Interrupt  33H,  function  lEH  898 

Interrupt  33H,  function  IFH  898 

Interrupt  33H,  function  02H  883 

Interrupt  33H,  function  03H  884 
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Interrupt  33H,  function  04H  884 

Interrupt  33H,  function  OSH  885 

Interrupt  33H,  function  06H  885 

Interrupt  33H,  function  07H  886 

Interrupt  33H,  function  08H  886 

Interrupt  33H,  function  09H  887 

Interrupt  33H,  function  lOH  891 

Interrupt  33H,  function  13H  891 

Interrupt  33H,  function  14H  892 

Interrupt  33H,  function  15H  893 

Interrupt  33H,  function  16H  893 

Intorupt  33H,  function  17H  894 

Interrupt  33H,  function  18H  894 

Interrupt  33H,  function  19H  896 

Interrupt  33H,  function  20H  898 

Interrupt  33H,  function  21H  899 

Interrupt  33H,  function  24H  899 


Mouse  pointer  618*  622,  882,  883 

Mouse  pointer  range  of  movement 

885,  886 

Mouse  pointer  shape 

886,  887 

Mouse  programming 

617 

Mouse  speed  doubling 

891 

Mouse  status  buffer  size 

893 

MOV  instruction 

47 

Move  file  pointer 

810 

Move  memory  areas 

754 

Move  mouse  pointer 

884 

MS-DOS 

51 

MSCDEX 

195 

MsDos  procedure  (Pascal) 

36 

MSDOS.SYS 

59 

MUL  instruction 

711 

Multiprocessing 

4,  835,  913 

Multisync  monitor 

255 

Multitasking 

835 

NEAR  instruction 

914 

Network 

819,  835-836 

Nibble 

914 

Non-destructive  read 

161 

Non-maskable  interrupt  (NMI)  23 ,  7 1 0 

Non-overlapping  segments 

11 

Norton  Utilities® 

208,  213 

Offset  address 

8,  42,  903 

Open 

165 

C^n  file  (FCB) 

782 

Open  file 

807 

Operating  system  area 

119 

OS/2 

687 

Oscillation 

447 

OUT 

464,  699, 914 

Output  buffer 

575 

Output  character  string 

778 

Output  status 

164,  817 

Output  until  busy 

167 

Overlapping  segments 

11 

Overlays 

114,  914 

Overscan  register 

856,  866 

Palette  register 

865,  877,  878 

Paragraph 

914 

Parameter  block 

111,  823 

Parent  program 

110,840,914 

Parity 

332,  914 

Parity  bit 

331 

Parse  filename  to  FCB 

795 

Partition  code 

689 

Partition  sector 

688 

Partitions 

323,  687-689 

Pascal 

100 

Paterson,  Tim 

52 

PATH 

112-113 

PC 

914 

PC  Tools® 

213 

PC-DOS 

51 

Periodic  interrupt 

764 

Peripheral  interface 

914 

Pipe  file 

134 

Pipes 

133 

Pixel 

724 

Pointer  position 

883,  884 

Pointer  speed 

890 

Ports 

699,  915 

Position  cursor 

717 

Predefined  handles 

70 

Primary  partition 

688 

Print  queue 

847 

Print  spooler 

846-847 

print  Character 

776 

Printer  access 

384,  758 

Printer  intermpt 

674 

Printer  output  functions 

73,  76 

Printer  status 

385,758 

Processor  registers 

219 
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Processor  type 

291 

Ready 

747 

Program  cils 

no 

Realtime  Clock  336,  395-397, 563, 

Program  counter 

6,  10 

674, 761-763 

Program  Segment  Prefix  (PSP)  60,  67 

Realtime  clock  regist^ 

564 

208,  769,  793, 915 

Recalibrate  hard  disk 

329,  748 

Program  termination 

766 

Receive  character 

334 

Programmable  peripheral  interface  13 

Receiver  shift  register 

333 

Programmable  timer 

448 

Redirect  device 

838 

Prompt 

57 

Redirection  of  interrupts 

156 

Protected  mode 

337,  915 

Refresh  rate 

461 

<Prt  So  key 

670 

Register 

6,35 

PSP  access 

769 

Relative  addresses 

8 

PTR  data  type 

155 

Release  extended  memory  pages  85 1 

Release  memory 

822 

RAM 

291,  325,  767,  915 

Relocation  factor 

114 

RAM  control 

767 

Removable  media 

167 

RAM  determination 

291 

Remove  directory 

93 

Random  block  read 

794 

Remove  file  from  print  queue  847 

Random  block  write 

795 

Remove  mouse  pointer 

883 

Random  read 

790 

Rename  file 

787,  828 

Random  write 

791 

Reserved 

846 

Raster 

462 

Reset  alarm  time 

763 

Raster-scan  devices 

460 

Reset  disk 

729 

Raw  mode  72.  150,  171,  814,  915 

Reset  hard  disk 

736,  737, 746 

Read 

161 

Reset  input  buffer  and  then  input  780 

Read  character 

720,  751,  775,  860 

Reset  mouse  driver 

882,  899 

Read  clock  count 

759 

Resident  commands 

51 

Read  control  keys 

361 

Resident  interrupt  driver 

373,  391,  675, 

Read  cursor  position 

232,  718 

679 

Read  data  from  block  device  816 

Restore  mouse  status 

893,  894 

Read  data  from  character  device  814 

ROM  BASIC 

222,  715,^16 

Read  date  from  realtime  clock  761 

ROM  cartridges 

18 

Read  Disk 

730 

ROM-BIOS 

221,  254,  905 

Read  disk  status 

299 

Root  directory 

202 

Read  display  mode 

726 

RS-232  card 

330,  916 

Read  file 

808 

Read  hard  disk 

325,  326,  736,737 

Scan  code 

360,  575, 916 

Read  hard  disk  format 

328 

Scan  lines 

877 

Read  HI-RAM  size 

337 

Screen  border  color 

865 

Read  input  status 

817 

Screen  controller 

^  14 

Read  Interrupt- Vector 

801 

Screen  refresh 

879 

Read  joystick 

753 

Scrolling 

859 

Read  Keyboard 

361,  756,  757 

Search  directory 

768 

Read  output  status 

817^ 

Search  for  match  (FCB) 

783-784 

Read  pixel 

238,  863 

Sector 

54,  916 

Read  printer  status 

758 

Sector  interleaving 

326 

Read  realtime  clock 

760 

Segment  address 

8,  903 

Read  status 

752 

Segment  descriptor 

338 
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Segment  register  6,  8, 42,  916 

Segmented  address  8 

Spread  40 

Select  color  palette  723 

Select  Current  Drive  781 

Select  current  display  page  719 

Select  drive  781 

Select  palette  723 

Send  Character  775 

Send  character  (BIOS  printer)  385 

Send  data  to  block  device  816 

Send  data  to  character  device  815 

Send  file  to  print  spooler  847 

Sensegraphic  pixel  724 

Sequential  read  785 

Sequential  write  786 

Serial  interface  73,  330,  751 

Saial  interface  functions  73,  76,  330 
Serial  port  751 

Set  <Ctrl><Break>  flag  800 

Set  alarm  time  762 

Set  allocation  strategy  831 

Set  clock  count  760 

Set  country  804 

Set  current  directory  805 

Set  date  in  realtime  clock  762 

Set  disk  type  304 

Set  display  page  233 

Set  DTA  address  788 

Set  file  attributes  812 

Set  file  date  and  time  829 

Set  flag  after  time  interval  752 

Set  graphic  pixel  237,  724 

Set  mouse  display  page  622 

Set  mouse  event  handler  888 

Set  mouse  hardware  interrupt  rate  897 
Set  mouse  pointer  display  page  897 

Set  mouse  sensitivity  896 

Set  pointer  shape  (text  mode)  887 

Set  printer  setup  836 

Set  random  record  number  792 

Set  realtime  clock  761 

Set  system  date  797 

Set  system  time  797 

Set  Verify  flag  798 

Setting  333 

Scan  461 

Shell  907 


Signal  controller  460 

Single  step  667 

Single  step  interrupt  710 

Small  registers  7 

Software  interrupt  22, 9 16 

SORT  132 

Sound  447-451 

Sound  demonstration  program  45 1 

Special  keys  358 

Stack  segment  11 

Standard  input  device  917 

Standard  output  device  917 

Status  register  503,  564, 575 

STI  23, 917 

Stop  bits  331,  332 

Subdirectory  access  767 

SUBST  212 

Support  chips  13 

Switch  to  protected  mode  755 

System  configuration  292 

System  Request  754 

System  request  754 

Teletype  ouQrut  235 

Temporary  file  834 

Terminate  address  843 

Terminate  and  Stay  Resident  (TSR) 

407,  846 

Terminate  program  142,  767,  773,  825 

Terminate  with  return  code  825 

Test  for  changeable  block  device  818 

Test  for  local  or  remote  drive  818 

Test  for  local  or  remote  handle  819 

Text  cursor  emulation  879 

Text  mode  458 

Time  395,  759-763,  768,  797,  829 
Time  and  date  767 

Time  measurement  54,  336,  395 

Time-out  error  333,  384, 917 

Timekeeping  395 

Timer  14, 448,  673, 917 

TPA — see  Transient  Program  Area 
Trace  mode  668 

Traditional  input/output  functions  74 

Transfer  holding  register  333 

Transfer  shift  register  333 

Transient  commands  5 1 

Transient  Program  Area  (TPA)  1 19, 903 
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Transmit  characters 

334 

TRAP  bit 

710 

Truncate  file 

806 

TSR  846TSR  programs 

407 

Turbo  C  Compiler 

45,  416 

Turbo  Pascal  string 

38 

Typematic 

577-579 

UART 

332 

Undocumented  DOS  structures 

208 

Unfiltered  character  input  without  echo 

777 

UNK  54,  70,  84,  196 

Upwardly  compatible 

903 

User  interface 

617 

Verify  disk 

732 

Verify  flag 

798,  828 

Verify  sector 

326,  740 

Vertical  synchronization  signal 

483 

VGA  BIOS 

254 

VGA  character  generator 

263 

VGA  Interrupts: 

Interrupt  lOH,  function  lAH  881 

Interrupt  lOH,  function  lOH 

866-871 

IntOTupt  lOH,  function  IIH 

sub-function  04H 

874-876 

Interrupt  lOH,  function  12H 

sub-function  31H 

878-879 

VGA  video  modes 

255 

Video  cards 

14,  457 

Video  controller 

458 

Video  controllCT  registers 

472 

Video  functions 

713 

Video  Graphics  Array  (VGA) 

254,  458 

Video  mode 

231,  856 

Video  page 

908 

Video  RAM  458,482,856 

Video  table 

764  715 

Virtual  memory 

4,917 

Volume 

917 

Wait 

754 

Wildcards 

96 

Wad 

16 

Word  length 

331,  332 

Write 

163 

Write  character  722,  757,  861,  864 
Write  character/attribute  721 ,  860 

Write  character/color  861 

Write  to  disk  731 

Write  to  file  809 

Write  wi  th  verify  163 

XENIX  196, 687 
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For  your  convenience,  the  program  listings  contained  in  this  book  are  available  on 
two  IBM  5  1/4  inch  floppy  diskettes.  You  should  order  the  diskettes  if  you  want  to 
use  the  programs  but  don't  want  to  type  them  in  from  the  listings  in  the  book. 

All  programs  on  the  diskettes  have  been  fully  tested.  You  can  change  the  programs 
for  your  particular  needs.  The  two-diskette  set  is  available  for  $19.95  +  $2.00  for 
postage  and  handling  withing  the  U.S.A.  ($5.00  foreign  orders). 

When  ordering,  please  give  your  name  and  shipping  address.  Enclose  a  check, 
money  order  or  credit  card  information.  Mail  your  order  to: 

Abacus 

5370  52nd  St.  S.E. 

Grand  Rapids,  MI  49512 

Or  for  fast  service,  call  616/698-0330 

For  orders  only  call  1-800-451-4319 
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An  in-depth  reference  for  the  DOS  programmer 


PC  System  Programming  for  Developers  is  a  literal  encyclopedia  for  the  DOS  programmer. 
Whether  you  program  in  assembly  language,  C,  Pascal  or  BASIC,  you’ll  find  dozens  of  practical, 
parallel  working  examples  in  each  of  these  languages. 

PC  System  Programming  for  Developers  clearly  describes  the  technical  aspects  of  program¬ 
ming  under  DOS,  More  than  900  pages  are  devoted  to  making  DOS  programming  easier. 


Some  of  the  topics  covered  include: 

•  PC  memory  organization 

•  Using  extended  and  expanded  memory 

•  Hardware  and  software  interrupts 

•  COM  and  EXE  programs 

•  Handling  program  interrupts  in  BASIC, 
Turbo  Pascal,  C  and  assembly  language 


•  DOS  structures  and  functions 

•  Fundamentals  of  the  BIOS 

•  Programming  graphics  cards 

•  TSR  programs  and  more 

•  Writing  device  drivers 


Look  for  other  books  in  our  Developer's  Series. 


Includes  two  companion  disks  with  over  1  MB  of  source  code. 
These  disks  contain  all  the  source  files  listed  in  the  book  - 
complete  and  error-free. 

Saves  you  hours  of  typing  in  the  listings! 
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